> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# listar pedidos

> retorna a lista de pedidos da loja



## OpenAPI

````yaml /integracoes/store/store.json get /orders
openapi: 3.0.3
info:
  title: API sell-out
  description: API para gerenciamento de lojas e pedidos na plataforma teceo
  version: 1.0.0
servers:
  - url: https://api.teceo.co/store/v1
    description: produção
security:
  - bearerAuth: []
paths:
  /orders:
    get:
      tags:
        - pedidos
      summary: listar pedidos
      description: retorna a lista de pedidos da loja
      operationId: listOrders
      parameters:
        - name: page
          in: query
          description: número da página
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: quantidade de itens por página
          schema:
            type: integer
            default: 20
            maximum: 100
        - name: status
          in: query
          description: filtrar por status
          schema:
            type: string
            enum:
              - pending
              - confirmed
              - shipped
              - delivered
              - cancelled
      responses:
        '200':
          description: lista de pedidos retornada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Order'
                  meta:
                    $ref: '#/components/schemas/Pagination'
              example:
                data:
                  - id: ord_xyz789
                    number: PED-2025-0001
                    status: confirmed
                    total: 589.5
                    items_count: 12
                    brand:
                      id: brand_abc
                      name: distribuidora exemplo
                    created_at: '2025-01-14T10:00:00Z'
                meta:
                  total: 45
                  page: 1
                  limit: 20
                  pages: 3
        '401':
          description: não autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Order:
      type: object
      properties:
        id:
          type: string
          description: id único do pedido
        number:
          type: string
          description: número do pedido
        status:
          type: string
          enum:
            - pending
            - confirmed
            - shipped
            - delivered
            - cancelled
          description: status do pedido
        total:
          type: number
          format: float
          description: valor total do pedido
        items_count:
          type: integer
          description: quantidade de itens
        brand:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
        created_at:
          type: string
          format: date-time
    Pagination:
      type: object
      properties:
        total:
          type: integer
        page:
          type: integer
        limit:
          type: integer
        pages:
          type: integer
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        code:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````