Skip to main content
O parâmetro organization_uuid é obrigatório em todos os endpoints de listagem. Ele identifica de forma única o órgão público cadastrado na plataforma StartGov.
O organization_uuid é permanente — uma vez obtido, você pode armazená-lo na sua aplicação e reutilizá-lo em todas as consultas.

​
Como obter

1

Entre em contato com o suporte

Envie um e-mail para yves.cleuder@startgov.com.br com as seguintes informações:
  • Nome completo do órgão
  • CNPJ do órgão
  • Finalidade de uso da API (ex: integração com portal próprio, sistema interno, etc.)
Nossa equipe retornará em até 2 dias úteis com o UUID correspondente.
2

Receba seu UUID

Você receberá um identificador no formato UUID v4:
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Exemplo:
3f7a2c10-85e1-4b3d-9f2a-1c4e8d6b0a72
Guarde esse valor — ele é o identificador permanente do seu órgão na plataforma.
3

Valide o UUID recebido

Antes de usar o UUID em produção, confirme que ele está ativo no portal:
curl https://api.startgov.com.br/v1/transparency/validate-organization/3f7a2c10-85e1-4b3d-9f2a-1c4e8d6b0a72
Resposta de sucesso:
{
  "success": true,
  "message": "Organização validada com sucesso",
  "data": null
}
Se a resposta retornar "success": false, o UUID informado não corresponde a nenhum órgão publicado no portal. Verifique com o suporte se o cadastro foi concluído.

​
Próximos passos

Com o organization_uuid em mãos, você já pode consultar qualquer endpoint do Portal da Transparência:

Listar licitações

Listar ARPs

Listar contratos

Listar ordens de fornecimento