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

# Branch

> The physical or legal site where employees work.

The **Branch** is a **physical or legal site** where people work — a branch office, factory,
office or warehouse. It answers the question: **"Where does the employee work?"**

<Info>
  In occupational health, different branches can have completely different exposure profiles,
  even within the same company. That's why the Branch is the first level of the
  [hierarchy](/public-api/en/concepts/hierarchy_en).
</Info>

## Main fields

| Field                     | Required  | Description                                                               |
| ------------------------- | --------- | ------------------------------------------------------------------------- |
| `organization_id`         | yes       | Organization the branch belongs to.                                       |
| `display_name`            | yes       | Branch display name.                                                      |
| `cnpj`                    | yes       | Branch CNPJ (may differ from the organization's CNPJ).                    |
| `company_name`            | on create | Legal company name.                                                       |
| `cnae`                    | no        | CNAE economic-activity code.                                              |
| `hr_code`                 | no        | Client's internal HR code.                                                |
| `client_integration_code` | no        | Client's external identifier (idempotency/mapping).                       |
| Address                   | no        | `street`, `number`, `complement`, `neighborhood`, `city`, `state`, `cep`. |
| `is_active`               | no        | Active/inactive (default `true`).                                         |

<Note>
  `client_integration_code` maps the Salú record to the ID in **your** system and is also
  available as a list filter — enabling idempotent syncs. See
  [How to use §3](/public-api/en/how-to-use#en-3).
</Note>

## Examples

| Branch                   | Question it answers |
| ------------------------ | ------------------- |
| São Paulo office         | Where?              |
| Rio de Janeiro factory   | Where?              |
| Belo Horizonte warehouse | Where?              |

## Endpoints

<CardGroup cols={2}>
  <Card title="List branches" icon="list" href="/public-api/en/endpoints/branches/public_list_branches_v0_branch__get_en" />

  <Card title="Create branch" icon="plus" href="/public-api/en/endpoints/branches/public_create_branch_v0_branch__post_en" />
</CardGroup>