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

# Organização

> A empresa cliente que detém os dados na Salú.

A **Organização** representa a empresa cliente dentro da Salú — a entidade dona de todas as
Unidades, Setores, Cargos, Colaboradores e Pendências. Toda chamada da API pública opera
**no escopo das organizações** às quais a sua `x-api-key` tem acesso.

<Info>
  A sua chave pode ter acesso a **uma ou mais** organizações. Use o endpoint de listagem
  para descobrir os `organization_id` disponíveis para a sua integração.
</Info>

## Campos principais

| Campo                   | Descrição                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------- |
| `id`                    | Identificador (UUID) da organização. Usado como `organization_id` nos demais recursos. |
| `name` / `display_name` | Nome da organização.                                                                   |
| `cnpj`                  | CNPJ da organização (ver [glossário](/public-api/br/conceitos/glossario-br)).          |
| `soc_code`              | Código de registro no SOC, quando aplicável.                                           |

<Note>
  A organização aponta para um **customer** (cliente), que é o dono dos parâmetros de exame e
  das configurações de saúde ocupacional. Esses parâmetros influenciam, por exemplo, a
  periodicidade dos exames — mas são gerenciados pela Salú, não pela API pública.
</Note>

## Multi-organização

Como a `x-api-key` pode abranger várias organizações, **sempre informe o `organization_id`**
ao criar Unidades, Setores, Cargos e Colaboradores, para garantir que o registro seja criado
na empresa correta. Nos endpoints de listagem, `organization_id` também funciona como filtro.

## Relacionados

<CardGroup cols={2}>
  <Card title="Listar minhas organizações" icon="building" href="/public-api/br/endpoints/organizations/public_list_my_organizations_v0_organization__get">
    Endpoint para descobrir os `organization_id` disponíveis.
  </Card>

  <Card title="Hierarquia" icon="sitemap" href="/public-api/br/conceitos/hierarquia">
    Como Unidade, Setor e Cargo se combinam.
  </Card>
</CardGroup>