# Search claims This endpoint allows searching, through a valid token, which claims belong to a certain user. **GET** `/post-purchase/v1/claims/search` ## Request parameters ### Query - `id` (number, optional) Claim ID. Unique identifier used to reference a specific claim in the system, essential for tracking and managing these claims. - `type` (string, optional) Defines the nature of the claim being processed. It can take one of the following values: - `stage` (string, optional) he current stage of the claim within the processing cycle involving the buyer and seller. It can take one of the following values: - `status` (string, optional) The current state of the claim, indicating whether it is open or closed. It can take one of the following values: - `resource` (string, optional) Identificador del recurso sobre el que se crea el reclamo, such as a payment, order, shipment or purchase. It can take one of the following values: - `resource_id` (number, optional) ID of the resource on which the claim is created and depends on the previous parameter. - `date_created` (string, optional) Date and time when the message was created, formatted in ISO 8601 standard. For example, 2020-09-30T09:48:06.000-04:00. - `limit` (number, optional) Maximum number of claims to be retrieved. For example, setting this to '5' will return the top 5 claims. ## Response parameters - `paging` (object, optional) Information for pagination of search results. - `paging.offset` (number, optional) Offset over the total set of data gathered by the search. - `paging.limit` (number, optional) Limit of claims returned in the search. - `paging.total` (number, optional) Number of claims found in the search. - `data` (array, optional) Presents the data of the complaint. - `data[].id` (number, optional) Claim ID. Unique identifier used to reference a specific claim in the system, essential for tracking and managing these claims. - `data[].resource_id` (number, optional) ID of the resource on which the claim is created and depends on the 'resource' parameter. - `data[].status` (string, optional) Specifies the current state of the claim, indicating whether it is open or closed. It can take one of the following values: Possible enum values: - `opened` Indicates that the claim is open. - `closed` Indicates that the claim is closed. - `data[].type` (string, optional) Defines the nature of the claim being processed. It can take one of the following values: Possible enum values: - `mediations` Refers to the process of mediating between parties in a claim. - `cancel_purchase` Involves the process of cancelling a previously made purchase. - `return` Pertains to the process of returning a purchased item. - `cancel_sale` oncerns the process of cancelling a sale that has been made. - `change` Refers to the alteration or modification of the details or status of a claim. - `data[].stage` (string, optional) Indicates the current stage of the claim within the processing cycle involving the buyer and seller. It can take one of the following values: Possible enum values: - `claim` Initial stage of the claim process in which both the buyer and seller are involved. - `dispute` Phase where the claim is under dispute or disagreement. - `recontact` Stage in which one of the parties makes contact after the claim/dispute has been closed. - `none` Indicates no specific stage is currently applicable. - `data[].parent_id` (string, optional) ID of another claim on which it depends. - `data[].resource` (string, optional) Identificador del recurso sobre el que se crea el reclamo, such as a payment, order, shipment or purchase. Possible enum values: - `payment` Related to claims involving payment transactions. - `order` Pertains to claims arising from order processing issues. - `shipment` Concerns claims related to shipping or delivery matters. - `purchase` Involves claims associated with the purchase process. - `data[].reason_id` (string, optional) Reason ID of the claim. A claim can be created for three general reasons: Possible enum values: - `PNR` Product not received. - `PDD` Different or defective product. - `CS` Purchase cancellation. - `data[].fulfilled` (boolean, optional) Indicate whether the claim is for a delivered or undelivered product. - `data[].quantity_type` (string, optional) Indica si una devolución corresponde a todos los productos de la orden o solo algunos. Inicialmente sólo mostrará el valor 'total' y en el futuro se visualizará el valor 'partial'. - `data[].players` (array, optional) People who are participating in the complaint. - `data[].players[].role` (string, optional) Indicates the person's role within the claim. It can take one of the following values: Possible enum values: - `complainant` Person who claims - `respondent` Person to whom they are complaining. - `mediator` Person who intervenes to help solve the problem. - `data[].players[].type` (string, optional) Role that the person occupies in the operation that is being claimed and may vary according to the 'resource'. It can take one of the following values: Possible enum values: - `payment` Indicates that the person is the buyer or collector. - `order` Indicates that the person is the buyer or seller. - `shipment` Indicates that the person is the receiver or sender. - `data[].players[].user_id` (number, optional) ID of the 'type' indicated in the previous parameter. - `data[].players[].available_actions` (array, optional) Provides information about the actions that each of the involved parties can execute. - `data[].players[].available_actions[].action` (string, optional) Lista de acciones que pueden ejecutar cada una de las partes intervinientes. Possible enum values: - `send_message_to_complainant` Send a message to the buyer (with or without attachments). - `send_message_to_mediator` Send a message to the mediator (with or without attachments). - `recontact (no disponible aún)` Reopen a closed complaint through an interaction, such as a message. - `refund` Refund the buyer's money. Must be performed by the Mercado Pago front end. - `open_dispute` Initiate mediation. - `send_potential_shipping` Send a promise of shipment, indicating a date. - `add_shipping_evidence` Publish evidence that the product has been shipped. - `send_attachments` Send message with attached images. - `allow_return_label` Generate a return label. - `send_tracking_number` Send the shipping tracking number. - `data[].players[].available_actions[].due_date` (string, optional) Deadline to perform the action. - `data[].players[].available_actions[].mandatory` (boolean, optional) This field being 'true' indicates that the action is mandatory and must be performed within the specified time. - `data[].resolution` (object, optional) Provides information about claim resolution. - `data[].resolution.reason` (string, optional) Reason for resolution/closure. - `data[].resolution.date_created` (string, optional) Date of resolution/closure of the claim. - `data[].resolution.benefited` (string, optional) It will indicate who will benefit from resolving the claim. - `data[].resolution.closed_by` (string, optional) Person who closed the claim. - `data[].site_id` (string, optional) ID of the site where the request will be or was made, for example, "MPE" (Mercado Libre Perú). - `data[].date_created` (string, optional) Date the claim was created. - `data[].last_updated` (string, optional) Date of the last update to the claim. ## Request example ### cURL ```bash curl -X GET \ 'https://api.mercadopago.com/post-purchase/v1/claims/search?id=&type=&stage=&status=&resource=&resource_id=&date_created=&limit=' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` ## Response example ```json { "paging": { "offset": 0, "limit": 30, "total": 1 }, "data": [ { "id": 5033102536, "resource_id": 7138572864, "status": "closed", "type": "mediations", "stage": "dispute", "parent_id": null, "resource": "shipment", "reason_id": "PNR4071", "fulfilled": true, "quantity_type": "total", "players": [ { "role": null, "type": null, "user_id": null, "available_actions": null } ], "resolution": { "reason": "already_shipped", "date_created": "2020-10-02T01:12:31.000-04:00", "benefited": "complainant", "closed_by": "mediator" }, "site_id": "MPE", "date_created": "2020-09-30T09:48:06.000-04:00", "last_updated": "2020-10-02T01:12:31.000-04:00" } ] } ```