Buscar em pedidos comerciaishttps://api.mercadopago.com/merchant_orders/search
Encontre todas as informações dos pedidos gerados através de filtros específicos e por um intervalo de datas específico. Somente serão trazidos os dados dos últimos 90 dias (3 meses) e, caso queira buscar dados mais antigos, utilize o GET de "Obter pedido".
GET
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
Query
status
Status do pedido.string
preference_id
Identificação da preferência de pagamento associados à ordemstring
application_id
Id do aplicativostring
payer_id
Identificador de pagadorstring
Response parameters
elements
Contém os dados do pedido.array
next_offset
Campo numérico usado para paginar a resposta.number
total
Total de resultados da pesquisa.number
Erros
400Erro
ds_search_query
invalid query.
401Erro
invalid_token
invalid_token.
invalid_caller_id
invalid caller_id
Request
curl -X GET \
'https://api.mercadopago.com/merchant_orders/search?status=12123adfasdf123u4u&preference_id=12123adfasdf123u4u&application_id=12123adfasdf123u4u&payer_id=12123adfasdf123u4u&sponsor_id=12123adfasdf123u4u&external_reference=12123adfasdf123u4u&site_id=12123adfasdf123u4u&marketplace=12123adfasdf123u4u&date_created_from=12123adfasdf123u4u&date_created_to=12123adfasdf123u4u&last_updated_from=12123adfasdf123u4u&last_updated_to=12123adfasdf123u4u&items=12123adfasdf123u4u&limit=12123adfasdf123u4u&offset=12123adfasdf123u4u'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
Response
{
"elements": [
{
"id": 9999999999,
"status": "closed",
"external_reference": "default",
"preference_id": "Preference identification",
"payments": [
{
"id": 9999999999,
"transaction_amount": 1,
"total_paid_amount": 1,
"shipping_cost": 0,
"currency_id": "BRL",
"status": "approved",
"status_detail": "accredited",
"date_approved": "2019-04-02T18:35:35.000Z",
"date_created": "2019-04-02T18:35:34.000Z",
"last_modified": "2019-04-02T18:35:35.000Z",
"amount_refunded": 0
}
],
"shipments": [
{
"id": 99999999999,
"shipment_type": "shipping",
"shipping_mode": "me2",
"status": "delivered",
"items": [
{
"id": "not specified",
"description": "shipment item description",
"quantity": 1,
"dimensions": "1.0x10.0x23.0100.0"
}
],
"date_created": "2019-04-02T18:20:46.000Z",
"last_modified": "2019-04-12T19:36:48.000Z",
"date_first_printed": "2019-04-02T18:35:40.000Z",
"service_id": 999,
"sender_id": 999999999,
"receiver_id": 999999999,
"receiver_address": {
"id": 9999999999,
"address_line": "address line",
"city": {
"name": "City Name"
},
"state": {
"id": "AR-X",
"name": "state name"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": 0,
"longitude": 0,
"comment": "shipment comment",
"contact": "shipment contact",
"phone": 9999999999,
"zip_code": 9999,
"street_name": {
"en": "Street name",
"pt": "Nome da rua",
"es": "Nombre de la calle"
},
"street_number": 999
},
"shipping_option": {
"id": 999999999,
"cost": 0,
"currency_id": "BRL",
"shipping_method_id": 99999,
"estimated_delivery": {
"date": "2019-04-11T03:00:00.000Z"
},
"name": "Normal a domicilio",
"list_cost": 0,
"speed": {
"handling": 72,
"shipping": 72
}
}
}
],
"collector": {
"id": 999999999
},
"marketplace": "NONE",
"date_created": "2018-09-14T17:11:31.000Z",
"last_updated": "2018-09-14T17:11:43.000Z",
"shipping_cost": 0,
"total_amount": 5,
"site_id": "MLA",
"paid_amount": 5,
"refunded_amount": 0,
"payer": {
"id": 999999999,
"email": "test_user_ar@testuser.com"
},
"items": [
{
"id": "item id",
"category_id": "item category",
"currency_id": "BRL",
"description": "item description",
"picture_url": "item picture url",
"title": "item title",
"quantity": 1,
"unit_price": 5
}
],
"additional_info": "additional information",
"application_id": "10000000000000000",
"order_status": "paid"
}
],
"next_offset": 1,
"total": 1
}