---
title: "Listar pedidos"
method: GET
path: "/pedidos"
tags: ["Pedidos"]
---

# Listar pedidos

`GET /pedidos`

## Query parameters

- `numero` integer
- `nomeCliente` string
- `codigoCliente` string
- `cpfCnpj` string
- `dataInicial` string
- `dataFinal` string
- `dataAtualizacao` string
- `situacao` unknown
- `numeroPedidoEcommerce` string
- `idVendedor` integer
- `marcadores` string[]
- `origemPedido` 0 | 1
- `orderBy` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `itens` ListagemPedidoModelResponse[]
    - `id` integer, nullable
    - `situacao` integer, nullable
    - `numeroPedido` integer, nullable
    - `ecommerce` EcommerceResponseModel — 
      - `id` integer, nullable
      - `nome` string, nullable
      - `numeroPedidoEcommerce` string, nullable
      - `numeroPedidoCanalVenda` string, nullable
      - `canalVenda` string, nullable
    - `dataCriacao` string, nullable
    - `dataPrevista` string, nullable
    - `cliente` PedidoClienteModel — 
      - `nome` string, nullable
      - `codigo` string, nullable
      - `fantasia` string, nullable
      - `tipoPessoa` 'J' | 'F' | 'E' | 'X', nullable — - J - Juridica - F - Fisica - E - Estrangeiro - X - Estrangeiro No Brasil
      - `cpfCnpj` string, nullable
      - `inscricaoEstadual` string, nullable
      - `rg` string, nullable
      - `telefone` string, nullable
      - `celular` string, nullable
      - `email` string, nullable
      - `endereco` EnderecoModel — 
        - `endereco` string, nullable
        - `numero` string, nullable
        - `complemento` string, nullable
        - `bairro` string, nullable
        - `municipio` string, nullable
        - `cep` string, nullable
        - `uf` string, nullable
        - `pais` string, nullable
      - `id` integer
    - `valor` string, nullable
    - `vendedor` VendedorResponseModel — 
      - `id` integer
      - `nome` string, nullable
    - `transportador` TransportadorResponseModel — 
      - `id` integer, nullable
      - `nome` string, nullable
      - `fretePorConta` 'R' | 'D' | 'T' | '3' | '4' | 'S', nullable — - R - Remetente - D - Destinatario - T - Terceiros - 3 - Proprio Remetente - 4 - Proprio Destinatario - S - Sem Transporte
      - `formaEnvio` FormaEnvioResponseModel — 
        - `id` integer
        - `nome` string, nullable
      - `formaFrete` FormaFreteResponseModel — 
        - `id` integer, nullable
        - `nome` string, nullable
      - `codigoRastreamento` string, nullable
      - `urlRastreamento` string, nullable
    - `origemPedido` 0 | 1, nullable — - 0 - Pedido Venda - 1 - Pdv
  - `paginacao` PaginatedResultModel — 
    - `limit` integer
    - `offset` integer
    - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/olist/apis/olist-erp-api-v3.md) · [All operations](https://skmtc.net/olist/apis/olist-erp-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olist/olist-erp-api-v3/versions/c351400bb11f/schema)