AI resources
Get chargeback

This endpoint allows you to retrieve the full details of a chargeback case identified by its "id". The requester must be the seller who owns the case. The response includes the associated payments, disputed amount, reason, coverage information, documentation status, submitted files, and relevant dates. In case of success, the request will return a response with status 200.

GET

https://api.mercadopago.com/v1/chargebacks/{id}
Request parameters
Header
Authorization
string

REQUIRED

Access Token obtained through the developer panel. Must be sent in all requests.
X-Caller-Id
integer

REQUIRED

ID of the authenticated user (seller ID) and owner of the requested resource.
Path
id
string

REQUIRED

Numeric ID of the chargeback case to retrieve.
Response parameters
id
string
Unique identifier of the case.
payments
array
IDs of the payments associated with the case. May include multiple payments when they are cart or bundle purchases.
currency
string
Currency in which the disputed amount is.
amount
number
Total disputed amount.
Errors

400Request error.

invalid_path_param

One or more parameters provided in the request path are invalid. Please confirm them and provide valid values to try again.

403Access denied.

invalid_user_for_operation

The caller does not have permission to access the requested resource (not the owner of the case or supporting file).

404Case not found.

chargeback_not_found

The "id" of the chargeback is not numeric or does not exist.

500Generic error.

internal_error

A generic error occurred. Check the request and try again.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/chargebacks/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
       -H 'X-Caller-Id: 123456789' \
    
Response
{
  "id": "123456789",
  "payments": [
    {}
  ],
  "currency": "COP",
  "amount": "50.00",
  "reason": "unauthorized",
  "reason_id": "6",
  "coverage_applied": true,
  "coverage_eligible": true,
  "documentation_required": true,
  "documentation_status": "pending",
  "documentation": [
    {
      "type": "collector",
      "url": "https://storage.mlstatic.com/op/123/456789/comprobante.pdf",
      "description": "Comprobante de envío",
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  ],
  "date_documentation_deadline": "2024-02-15T23:59:59.000-03:00",
  "date_created": "2024-02-01T10:30:00.000-03:00",
  "date_last_updated": "2024-02-03T14:00:00.000-03:00",
  "live_mode": true
}