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

# Contratos públicos

> Ferramenta MCP list_business_public_contracts da Base39.

Lista contratos públicos por CNPJ do contratado, incluindo itens, termos aditivos e apostilamentos relacionados. Percorre todas as páginas disponíveis, inclusive dos itens. Preço: R\$ 0,00 (gratuito).

## Ferramenta

`list_business_public_contracts`

## Exemplo de chamada

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "list_business_public_contracts",
    "arguments": {
      "document": "19131243000197"
    }
  }
}
```

## Exemplo de resultado

> [tab] Resumo
>
> ```markdown theme={null}
> ### Contratos públicos
>
> 2 registro(s) encontrado(s).
>
> - **Tipo de registro:** contract
> - **Número de identificação:** C1
> - **Objeto informado:** Serviço de teste
> - **Nome do contratado:** Empresa de teste
> - **Data de assinatura:** 2025-01-02
> - **Valor inicial em reais:** 1000.00
> - **Valor final em reais:** 1234.56
>
> - **Tipo de registro:** amendment
> - **Número de identificação:** C1
> - **Número do termo aditivo:** T1
> - **Valor em reais, como texto decimal:** 234.56
> ```

> [tab] Dados
>
> ```json theme={null}
> {
>   "object": "list",
>   "data": [
>     {
>       "object": "public_contract",
>       "record_type": "contract",
>       "number": "C1",
>       "purpose": "Serviço de teste",
>       "contractor_name": "Empresa de teste",
>       "signed_at": "2025-01-02",
>       "initial_amount": "1000.00",
>       "final_amount": "1234.56"
>     },
>     {
>       "object": "public_contract",
>       "record_type": "amendment",
>       "number": "C1",
>       "amendment_number": "T1",
>       "amount": "234.56"
>     }
>   ],
>   "document": "19131243000197",
>   "updated_at": "2026-11-01T00:00:00Z"
> }
> ```

> [accordion] Parâmetros
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
>       "description": "CNPJ completo, com ou sem pontuação.",
>       "title": "CNPJ"
>     }
>   },
>   "required": [
>     "document"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "19131243000197"
>     }
>   ]
> }
> ```

> [accordion] Resultado
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "object": {
>       "type": "string",
>       "const": "list",
>       "description": "Coleção de objetos Base39."
>     },
>     "data": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "object": {
>             "type": "string",
>             "const": "public_contract",
>             "description": "Tipo do objeto Base39."
>           },
>           "record_type": {
>             "type": "string",
>             "enum": [
>               "contract",
>               "item",
>               "amendment",
>               "adjustment"
>             ],
>             "description": "Tipo de registro."
>           },
>           "number": {
>             "type": "string",
>             "description": "Número de identificação."
>           },
>           "purpose": {
>             "type": "string",
>             "description": "Objeto informado."
>           },
>           "legal_basis": {
>             "type": "string",
>             "description": "Fundamento legal."
>           },
>           "procedure": {
>             "type": "string",
>             "description": "Modalidade informada."
>           },
>           "status": {
>             "type": "string",
>             "description": "Situação informada."
>           },
>           "parent_authority_code": {
>             "type": "string",
>             "description": "Código do órgão superior."
>           },
>           "parent_authority_name": {
>             "type": "string",
>             "description": "Nome do órgão superior."
>           },
>           "authority_code": {
>             "type": "string",
>             "description": "Código do órgão."
>           },
>           "authority_name": {
>             "type": "string",
>             "description": "Nome do órgão."
>           },
>           "management_unit_code": {
>             "type": "string",
>             "description": "Código da unidade gestora."
>           },
>           "management_unit_name": {
>             "type": "string",
>             "description": "Nome da unidade gestora."
>           },
>           "contractor_name": {
>             "type": "string",
>             "description": "Nome do contratado."
>           },
>           "signed_at": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data de assinatura."
>           },
>           "publication_date": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data da publicação."
>           },
>           "start_date": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data de início."
>           },
>           "end_date": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data de término."
>           },
>           "initial_amount": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Valor inicial em reais."
>           },
>           "final_amount": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Valor final em reais."
>           },
>           "procurement_number": {
>             "type": "string",
>             "description": "Número da licitação."
>           },
>           "procurement_management_unit_code": {
>             "type": "string",
>             "description": "Código da unidade gestora da licitação."
>           },
>           "procurement_management_unit_name": {
>             "type": "string",
>             "description": "Nome da unidade gestora da licitação."
>           },
>           "procurement_procedure_code": {
>             "type": "string",
>             "description": "Código da modalidade da licitação."
>           },
>           "procurement_procedure": {
>             "type": "string",
>             "description": "Modalidade da licitação."
>           },
>           "item_code": {
>             "type": "string",
>             "description": "Código do item."
>           },
>           "item_description": {
>             "type": "string",
>             "description": "Descrição do item."
>           },
>           "item_additional_description": {
>             "type": "string",
>             "description": "Descrição complementar do item."
>           },
>           "quantity": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Quantidade informada, como texto decimal."
>           },
>           "item_amount": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Valor do item em reais."
>           },
>           "amendment_number": {
>             "type": "string",
>             "description": "Número do termo aditivo."
>           },
>           "adjustment_number": {
>             "type": "string",
>             "description": "Número do apostilamento."
>           },
>           "description": {
>             "type": "string",
>             "description": "Descrição informada."
>           },
>           "amount": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Valor em reais, como texto decimal."
>           },
>           "included_at": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data de inclusão."
>           }
>         },
>         "required": [
>           "object",
>           "record_type"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Objetos da coleção."
>     },
>     "next_cursor": {
>       "description": "Cursor opaco da próxima página; ausente ao final.",
>       "type": "string"
>     },
>     "document": {
>       "type": "string",
>       "minLength": 1,
>       "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
>     },
>     "updated_at": {
>       "type": "string",
>       "format": "date-time",
>       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
>       "description": "Data e hora da última atualização publicada, em ISO 8601."
>     }
>   },
>   "required": [
>     "object",
>     "data",
>     "document"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "object": "list",
>       "data": [
>         {
>           "object": "public_contract",
>           "record_type": "contract",
>           "number": "C1",
>           "purpose": "Serviço de teste",
>           "contractor_name": "Empresa de teste",
>           "signed_at": "2025-01-02",
>           "initial_amount": "1000.00",
>           "final_amount": "1234.56"
>         },
>         {
>           "object": "public_contract",
>           "record_type": "amendment",
>           "number": "C1",
>           "amendment_number": "T1",
>           "amount": "234.56"
>         }
>       ],
>       "document": "19131243000197",
>       "updated_at": "2026-11-01T00:00:00Z"
>     }
>   ]
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.