# Provide evidence for DEFEND

Endpoint to provide evidence for the DEFEND request for information.

A valid JWT token is required in order to perform requests against this API.
See Ratepay Authentication API specification.

Endpoint: POST /v1/disputes/{ratepay_dispute_id}/evidences/defend
Version: version
Security: Bearer Authentication

## Path parameters:

  - `ratepay_dispute_id` (string, required)
    Ratepay dispute ID
    Example: "OpK7rRZP0GND8MobcIKA"

## Header parameters:

  - `Authorization` (string, required)
    For each request, a valid access token must be provided in the Authorization header. See                       Authentication API for obtaining a valid token.

## Request fields (multipart/form-data):

  - `evidence` (object, required)

  - `evidence.ratepay_transaction_id` (string, required)
    Ratepay transaction ID.
    Example: "scwBgARW-nE93I7_ywhp"

  - `evidence.delivery_information` (array, required)
    List of objects containing delivery details.

  - `evidence.delivery_information.carrier_name` (string, required)
    Name of the shipping carrier used by the shop for the capture.
    Enum: "DHL", "UPS", "POST_AUSTRIA", "DPD", "SWISS_POST", "GLS", "ASENDIA", "HERMES_LOGISTICS", "FEDEX", "OTHER_WITH_TRACKING", "OTHER_WITHOUT_TRACKING"

  - `evidence.delivery_information.tracking_number` (string, required)
    Tracking number for order delivery. This field is optional for carrier_name: 'OTHER_WITHOUT_TRACKING'
    Example: 2.3834745636235124e+23

  - `evidence.delivery_information.status` (string)
    Current status of delivery.
    Enum: "PENDING", "DELIVERED", "RETURNED", "LOST"

  - `evidence.delivery_information.date` (string)
    Date when goods were delivered.
Must be in the format YYYY-MM-DD, in accordance with [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2019-05-17"

  - `evidence.delivery_information.address` (string)
    Delivery address.
Country code in accordance with [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)
    Example: "Alpenstrasse 21, 15432 DE"

  - `evidence.delivery_information.note` (string)
    Name of the delivery note file to be uploaded. The value will be used as a key to the binary file in the request.
The delivery note is required only in case of multiple captures, if the captures did not contain item information.

  - `additional_evidence` (string)
    File with additional evidence.
Allowed types are '.zip', '.pdf', '.jpg', '.png', '.gif', '.txt'. Maximum file size is 10 MB.

  - `file1` (string)
    Information about the items included in the shipment. Key name must correspond to the actual value of the evidence field.
Allowed types are '.zip', '.pdf', '.jpg', '.png', '.gif', '.txt'. Maximum file size is 10 MB.

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 422 fields (application/json):

  - `message` (string)
    Example: "Mandatory information missing."

  - `errors` (object)
    Example: {"message":"The submitted data is invalid.","evidence":["The Ratepay transaction ID is required.","The delivery_information.0.carrier_name is required.","The delivery_information.0.tracking_number is required."]}

  - `errors.field_name` (array)


## Response 201 fields