# Evidence file upload

## POST

Try it

Upload a single file as dispute evidence.

### Credentials

HTTP Basic basicAuth

### Header Parameters

| Parameter          | Type   | Required |
|--------------------|--------|----------|
| api-version        | string | *        |
| x-forter-siteid    | string | *        |

### Body Parameters

| Parameter                      | Type                              | Required |
|--------------------------------|-----------------------------------|----------|
| body                           | disputeEvidenceFileRequestRequest | *        |
| evidenceType                   | string<PROOF_OF_DELIVERY \\| PROOF_OF_REFUND \\| CUSTOMER_CORRESPONDENCE \\| CONTRACT_PAGE \\| INVOICE \\| RECURRING_BILLING_AGREEMENT \\| PROOF_OF_RECURRING_AGREEMENT_NOTICE \\| ACCEPTANCE_OF_RECURRING_BILLING_AGREEMENT \\| PROOF_OF_REQUESTED_CANCELLATION \\| PROOF_OF_ORDER_REPLACEMENT \\| PROOF_OF_POSSESSION_OR_USAGE \\| SOCIAL_NETWORK_REPUTATION \\| PROOF_OF_RESIDENCE \\| EMAIL_CONFIRMATION \\| PASSENGER_OR_CUSTOMER_DETAILS \\| FLIGHT_MANIFEST \\| HOTEL_NO_SHOW \\| AUTHENTICATION_CERTIFICATE \\| TERMS_AND_CONDITIONS \\| USER_TERMS_AND_CONDITION_ACCEPTANCE \\| CARDHOLDER_VERIFICATION_DOCUMENT \\| RELATED_INVOICE_HISTORY \\| PURCHASE_HELD_IN_CUSTOMS \\| DELAY_DISCLOSURE \\| BUYER_REVIEW_SURVEY \\| OTHER> | *        |
| filePath                       | string                            | *        |
| orderId                        | string                            | nullable  |
| processorCaseNumber            | string                            | nullable  |
| processorChargeId              | string                            | nullable  |

### Responses

#### 200

**Example** disputeEvidenceFileResponse

The response object following uploading dispute evidence file request to the system

| Parameter | Type   | Required |
|-----------|--------|----------|
| message   | string | *        |
| status    | string | *        |

#### 400

**Bad Request**

| Parameter | Type   | Required |
|-----------|--------|----------|
| message   | string<CLAIM_NOT_FOUND \\| SCHEMA_VALIDATION_FAILED> | * |
| status    | string<FAILED>                         | *        |

#### 401

Unauthorized (No valid API key provided)

#### 404

Not Found (The requested item doesn't exist)

#### 500

**Server Error**

| Parameter | Type   | Required |
|-----------|--------|----------|
| message   | string<SERVICE_UNAVAILABLE> | * |
| status    | string<FAILED>                       | *        |

### Request

**Curl**

```bash
curl --request POST \ 
--url https://api.forter-secure.com/v3/disputes/evidence/file \ 
--header 'accept: application/json' \ 
--header 'content-type: application/json' \ 
--header 'api-version: 10.1' \ 
--header 'x-forter-siteid: a1b2c3d4e5f6' \ 
--data '{
  "evidenceType": "PROOF_OF_DELIVERY",
  "filePath": "s3://forter-bucket/client-folder/dispute-evidence/example-16451.pdf"
}'
```

### Responses

#### 200

**Example**
```json
{
  "message": "EVIDENCE_UPLOADED",
  "status": "SUCCESS"
}
```