Buscar pedido
O pedido completo, no formato do padrão Open Delivery 1.4.0.
Autorização
oauth2 orders:readOAuth 2.0 client_credentials. Troque client_id e client_secret por um token em
POST /oauth/token e envie Authorization: Bearer <access_token>. O token vale 3600
segundos, sem refresh token. Os escopos são definidos pelo lojista ao criar a credencial e
não podem ser alterados depois; o token carrega exatamente os escopos da credencial.
Em: header
Escopo: orders:read
Parâmetros de caminho
Identificador do pedido (GUID). É o orderId dos eventos e o id do pedido. Um valor que não é GUID responde 404 no formato ProblemDetails.
uuidCorpo da resposta
application/json
application/json
application/json
application/json
application/json
curl "https://api.meupedido.io/open-delivery/v1/orders/9b1e2d3c-4f5a-4b6c-8d7e-0f1a2b3c4d5e" \ -H "Authorization: Bearer $ACCESS_TOKEN"Saída real do serializador para um pedido da loja de teste. Campos que a API ainda não preenche chegam como null.
{ "id": "9b1e2d3c-4f5a-4b6c-8d7e-0f1a2b3c4d5e", "displayId": "1042", "type": "DELIVERY", "orderTiming": "INSTANT", "createdAt": "2026-09-19T14:32:10Z", "preparationStartDateTime": "2026-09-19T14:32:10Z", "merchant": { "id": "6d2f4c8a-1b3e-4f5a-9c7d-2e8b0a1f3c5d", "name": "Loja de teste Acme" }, "customer": { "id": "a4b5c6d7-e8f9-4a0b-8c1d-2e3f4a5b6c7d", "name": "Ana Souza", "phone": { "number": "11999990000", "extension": null }, "documentNumber": null, "email": null, "ordersCountOnMerchant": null }, "items": [ { "id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b", "index": null, "name": "Pizza Margherita Grande", "externalCode": "3c2b1a09-8f7e-4d6c-b5a4-9382716f5e4d", "unit": null, "ean": null, "quantity": 1, "specialInstructions": "Sem manjericão", "unitPrice": { "value": 49.9, "currency": "BRL" }, "optionsPrice": { "value": 8, "currency": "BRL" }, "totalPrice": { "value": 57.9, "currency": "BRL" }, "options": [ { "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d", "index": null, "name": "Borda recheada", "externalCode": "b8a7c6d5-e4f3-4210-9876-543210fedcba", "quantity": 1, "unit": null, "unitPrice": { "value": 8, "currency": "BRL" }, "price": { "value": 8, "currency": "BRL" }, "groupName": null } ] } ], "otherFees": [ { "name": "Taxa de entrega", "type": "DELIVERY", "receivedBy": "MERCHANT", "price": { "value": 7, "currency": "BRL" } } ], "discounts": null, "total": { "items": { "value": 57.9, "currency": "BRL" }, "otherFees": { "value": 7, "currency": "BRL" }, "discount": { "value": 0, "currency": "BRL" }, "orderAmount": { "value": 64.9, "currency": "BRL" } }, "payments": { "prepaid": 0, "pending": 64.9, "methods": [ { "value": 64.9, "currency": "BRL", "method": "CREDIT", "methodInfo": "Cartão de crédito", "type": "OFFLINE", "changeFor": null, "brand": null, "transaction": null } ] }, "delivery": { "deliveryDateTime": null, "estimatedDeliveryDateTime": null, "deliveredBy": "MERCHANT", "deliveryAddress": { "country": "BR", "state": "SP", "city": "São Paulo", "district": "Pinheiros", "street": "Rua dos Pinheiros", "number": "1000", "postalCode": "05422001", "complement": "Apto 42", "reference": null, "formattedAddress": null, "coordinates": { "latitude": -23.5656, "longitude": -46.6898 } } }, "takeout": null, "schedule": null, "extraInfo": "Interfone 42 | origem=SITE", "test": true}