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

# Flow: PCD analysis

> Record and track a person-with-a-disability analysis.

The [PCD analysis](/public-api/en/concepts/pcd-analysis_en) validates the
**person-with-a-disability** condition of a candidate or employee.

## Sequence

```mermaid theme={null}
sequenceDiagram
    participant C as Your system
    participant API as Salú API
    C->>API: POST /v0/analysis/disability (name, gov_id, organization_id, [employee_id])
    API-->>C: 201 Created (analysis in PENDING status)
    API-->>API: internal review
    C->>API: GET /v0/analysis/{analysis_id} (track status)
    API-->>C: APPROVED or REJECTED
```

## Step by step

<Steps>
  <Step title="Create the analysis">
    `POST /v0/analysis/disability` with `name`, `gov_id` (CPF) and `organization_id`. If the
    candidate **is already an employee**, also provide `employee_id`.
  </Step>

  <Step title="Track the status">
    Read by `id` (`GET /v0/analysis/{analysis_id}`) or list (`GET /v0/analysis/`) and track the
    `status` (`PENDING` → `APPROVED`/`REJECTED`).
  </Step>

  <Step title="Disabilities reference">
    Use `GET /v0/analysis/disability/disabilities` to get the supported disability groups and
    types.
  </Step>

  <Step title="Associate with the employee (when applicable)">
    When registering/updating a PCD employee (`is_disabled = true`), the
    `disability_analysis_id` can point to the approved analysis.
  </Step>
</Steps>