GET/v2/pedidos

Listar pedidos

Retorna uma lista paginada de pedidos da sua conta. Use os filtros de status e período para refinar os resultados. A ordenação padrão é por data de criação, do mais recente para o mais antigo.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
status	string	não	Filtra por status: pendente, pago, enviado, entregue ou cancelado.
cliente_id	string	não	Retorna apenas pedidos de um cliente específico.
criado_apos	ISO 8601	não	Pedidos criados após esta data (inclusive).
limite	integer	não	Itens por página. Padrão 20, máximo 100.
cursor	string	não	Cursor de paginação retornado na resposta anterior.

Response · 200 OK

{
  "itens": [
    {
      "id": "ped_9f3k2m1x",
      "status": "pago",
      "cliente": {
        "id": "cli_7h2j9s",
        "nome": "Mariana Duarte"
      },
      "total_centavos": 18990,
      "moeda": "BRL",
      "criado_em": "2026-07-10T14:32:00Z"
    },
    {
      "id": "ped_8e1n4p7q",
      "status": "enviado",
      "cliente": {
        "id": "cli_3k8m2v",
        "nome": "Rafael Nogueira"
      },
      "total_centavos": 45900,
      "moeda": "BRL",
      "criado_em": "2026-07-09T09:15:00Z"
    }
  ],
  "paginacao": {
    "proximo_cursor": "cur_a8f7d6",
    "tem_mais": true
  }
}

curl -X GET "https://api.pedidos.dev/v2/pedidos?status=pago&limite=20" \
  -H "Authorization: Bearer $PEDIDOS_API_KEY" \
  -H "Accept: application/json"

Testar agora

Sandbox

GET/v2/pedidos

status

limite