# List orders

Returns order list

Endpoint: GET /orders
Version: 1.1.0
Security: bearerAuth

## Query parameters:

  - `start` (string)
    Start date
    Example: "2021-01-01"

  - `end` (string)
    End date
    Example: "2021-01-01"

## Response 200 fields (application/json):

  - `codigo` (number)
    Código do pedido
    Example: 1234

  - `dataHora` (string)
    Data e hora do pedido (ISO 8601)
    Example: "2025-08-26T12:34:56Z"

  - `cliente` (object)

  - `cliente.nome` (string)
    Nome do cliente
    Example: "João Silva"

  - `cliente.telefone` (string)
    Telefone do cliente
    Example: "11912345678"

  - `itens` (array)

  - `itens.tipo` (string)
    Enum: "VARIAVEL", "FIXO"

  - `itens.nome` (string)
    Example: "Açai - 500ml - Frozen"

  - `itens.codigoPdv` (number)
    Example: 12

  - `itens.observacao` (string)
    Example: "Muito leite condensado"

  - `itens.quantidade` (number)
    Example: 1

  - `itens.preco` (number)
    Example: 26

  - `itens.descricao` (string)
    Example: "Escolha sua calda:  Chocolate  (2x),  Mel  (1x). Escolha seu acompanhamento:  Serenata de Amor  (3x). Escolha sua fruta:  Laranja  (2x). Adicional extra:  Iogurte Natural  (2x),  Serenata de Amor  (2x),  Morango 50g  (2x). Precisa de talheres de plástico?:  Não, quero ajudar a reduzir o consumo de plástico . "

  - `itens.produto` (object)

  - `itens.produto.tamanho` (string)
    Example: "Trio (batata e refri)"

  - `itens.produto.tamanhoPdv` (number)
    Example: 31

  - `itens.opcionais` (array)

  - `itens.opcionais.campo` (string)
    Example: "Hambúrguer com"

  - `itens.opcionais.opcao` (array)

  - `itens.opcionais.opcao.price` (number)
    Example: 23

  - `pagamentos` (array)

  - `pagamentos.codigo` (number)
    Example: 3

  - `pagamentos.status` (string)
    Enum: "PAID", "NO_PAID"

  - `pagamentos.troco` (number)
    Example: 50

  - `pagamentos.transactionId` (string)
    Example: "12451"

  - `status` (string)
    Status atual do pedido
    Example: "CONFIRMADO"

  - `tipoEntrega` (string)
    Tipo de entrega do pedido
    Enum: "DELIVERY", "RETIRADA"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "Bearer Token invalid or expired"

## Response 403 fields (application/json):

  - `error` (string)
    Example: "Bearer Token missing or does not exist"