> ## Documentation Index > Fetch the complete documentation index at: https://docs.startgov.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Listar contratos > Retorna uma lista paginada de contratos publicados no portal de transparência. ## OpenAPI ````yaml GET /transparency/contracts openapi: 3.0.3 info: title: StartGov — Portal da Transparência version: 1.0.0 description: >- API pública do Portal da Transparência da plataforma StartGov. Todos os endpoints são públicos e não requerem autenticação. servers: - url: https://api-bid.startgov.com.br/v1 description: Produção security: [] tags: - name: Licitações description: Processos licitatórios formais - name: Contratações Diretas description: Dispensas e inexigibilidades - name: Adesões description: Adesões a ARPs externas (carona) - name: Chamamentos Públicos description: Chamamentos públicos - name: ARPs description: Atas de Registro de Preços - name: Contratos description: Contratos de fornecimento - name: Ordens de Fornecimento description: Ordens emitidas contra contratos e ARPs - name: Auxiliares description: 'Endpoints de suporte: validação, enumerações e exportação' paths: /transparency/contracts: get: tags: - Contratos summary: Listar contratos description: >- Retorna uma lista paginada de contratos publicados no portal de transparência. operationId: listContracts parameters: - $ref: '#/components/parameters/organization_uuid' - $ref: '#/components/parameters/date_from' - $ref: '#/components/parameters/date_to' - name: contracts_status_id in: query description: >- ID do status do contrato. Use `/transparency/managementStatuses` para obter os IDs disponíveis. schema: type: integer - $ref: '#/components/parameters/bidding_modality_id' - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/year' - $ref: '#/components/parameters/per_page' - name: with_relations in: query description: >- Relações a incluir, separadas por vírgula. Valores aceitos: `documents`, `terms`, `orders`, `commitments`. schema: type: string example: documents,terms,orders,commitments responses: '200': description: Lista paginada de contratos content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessResponse' - properties: data: $ref: '#/components/schemas/PaginatedContracts' components: parameters: organization_uuid: name: organization_uuid in: query required: true description: UUID da organização schema: type: string format: uuid date_from: name: date_from in: query description: >- Data inicial do filtro (YYYY-MM-DD). Deve ser usado em conjunto com `date_to`. schema: type: string format: date example: '2024-01-01' date_to: name: date_to in: query description: >- Data final do filtro (YYYY-MM-DD). Deve ser usado em conjunto com `date_from`. schema: type: string format: date example: '2024-12-31' bidding_modality_id: name: bidding_modality_id in: query description: >- ID da modalidade licitatória. Use `/transparency/biddingModalities` para obter os IDs disponíveis. schema: type: integer search: name: search in: query description: Busca textual no objeto e número do processo schema: type: string year: name: year in: query description: Filtro por ano do exercício schema: type: integer example: 2024 per_page: name: per_page in: query description: 'Número de registros por página. Mínimo: `1`. Máximo: `100`.' schema: type: integer default: 20 minimum: 1 maximum: 100 schemas: SuccessResponse: type: object properties: success: type: boolean example: true message: type: string example: Dados recuperados com sucesso data: {} PaginatedContracts: allOf: - $ref: '#/components/schemas/PaginationMeta' - type: object properties: data: type: array items: $ref: '#/components/schemas/ContractListItem' PaginationMeta: type: object properties: current_page: type: integer example: 1 per_page: type: integer example: 20 total: type: integer example: 150 last_page: type: integer example: 8 from: type: integer example: 1 to: type: integer example: 20 ContractListItem: type: object properties: uuid: type: string format: uuid id: type: string format: uuid contract_uuid: type: string format: uuid nullable: true bidding_uuid: type: string format: uuid nullable: true company_name: type: string example: Prefeitura Municipal de Exemplo company_name_short: type: string contractor_company_name: type: string object_details: type: string amount_total: type: string number: type: string example: 001/2024 status_id: type: integer status: type: string bidding_number: type: string bidding_modality_id: type: integer bidding_modality: type: string date_start: type: string format: date date_end: type: string format: date term_title: type: string precision: type: integer managers: type: array description: >- Gestores do contrato. Sempre presente; pode ser `[]` quando não houver vínculos. CPF é exibido ofuscado. items: type: object properties: role: type: string example: Gestor name: type: string example: Maria de Souza cpf: type: string description: CPF ofuscado example: '***.456.789-**' office: type: string nullable: true example: Secretária de Compras inspectors: type: array description: >- Fiscais do contrato. Sempre presente; pode ser `[]` quando não houver vínculos. CPF é exibido ofuscado. items: type: object properties: role: type: string example: Fiscal name: type: string example: João da Silva cpf: type: string description: CPF ofuscado example: '***.456.789-**' office: type: string nullable: true example: Engenheiro Civil commitments: type: array description: >- Empenhos vinculados ao contrato. Retornado apenas quando solicitado via `with_relations=commitments`. items: type: object properties: year: type: integer example: 2026 number: type: string example: 2026NE000123 emission_date: type: string format: date example: '2026-04-15' description: type: string example: Empenho referente à 1ª parcela do contrato value: type: string example: '12345.67' expense_account_code: type: string example: 3.3.90.30.00 expense_account_name: type: string example: Material de Consumo published_bidding: type: integer enum: - 0 - 1 description: 1 se a licitação de origem também está publicada no portal ````