> ## 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.

# Obtendo o UUID

> Como identificar o UUID do seu órgão para usar nos endpoints do Portal da Transparência.

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.

<Info>
  O `organization_uuid` é permanente — uma vez obtido, você pode armazená-lo na sua aplicação e reutilizá-lo em todas as consultas.
</Info>

## Como obter

<Steps>
  <Step title="Entre em contato com o suporte">
    Envie um e-mail para [**yves.cleuder@startgov.com.br**](mailto: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.
  </Step>

  <Step title="Receba seu UUID">
    Você receberá um identificador no formato UUID v4:

    ```text theme={null}
    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    ```

    **Exemplo:**

    ```text theme={null}
    3f7a2c10-85e1-4b3d-9f2a-1c4e8d6b0a72
    ```

    Guarde esse valor — ele é o identificador permanente do seu órgão na plataforma.
  </Step>

  <Step title="Valide o UUID recebido">
    Antes de usar o UUID em produção, confirme que ele está ativo no portal:

    ```bash theme={null}
    curl https://api-bid.startgov.com.br/v1/transparency/validate-organization/3f7a2c10-85e1-4b3d-9f2a-1c4e8d6b0a72
    ```

    **Resposta de sucesso:**

    ```json theme={null}
    {
      "success": true,
      "message": "Organização validada com sucesso",
      "data": null
    }
    ```

    <Warning>
      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.
    </Warning>
  </Step>
</Steps>

## Próximos passos

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

<CardGroup cols={2}>
  <Card title="Listar licitações" icon="gavel" href="/api-reference/transparency/biddings/list" />

  <Card title="Listar ARPs" icon="file-contract" href="/api-reference/transparency/arps/list" />

  <Card title="Listar contratos" icon="file-signature" href="/api-reference/transparency/contracts/list" />

  <Card title="Listar ordens de fornecimento" icon="truck" href="/api-reference/transparency/orders/list" />
</CardGroup>