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

# TST

> Brazil's labour-debt certificate (CNDT) for any company, by CNPJ: whether it owes labour debts, whether they are secured or suspended, and the cases behind them, issued live by the Tribunal Superior do Trabalho.

The Tribunal Superior do Trabalho keeps the national register of labour
debtors, fed by the 24 regional labour courts, and issues from it the
Certidão Negativa de Débitos Trabalhistas (CNDT). Brazilian law requires it in
public tenders, and it is the standard check on whether a company pays what
the labour courts ordered. One certificate covers every establishment of the
company.

Send a CNPJ and get a new certificate: clear, with debts, or with debts that
are all secured or suspended, each case with its court and whether the debt
is secured, and the official PDF if you want it.

`POST /br/tst/labour-certificate/v1` Issues a new certificate for a company and returns what it says.

| Field             | Type    | Notes                                                                                                                                      |
| ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `document_number` | string  | **Required.** **Required.** The company's CNPJ, with or without punctuation, e.g. `33.000.167/0001-01`. Companies only: a CPF is rejected. |
| `include_pdf`     | boolean | Optional. `true` to also get `pdf_url`, a link to the official certificate PDF. Default `false`.                                           |

```bash theme={"dark"}
curl https://api.croma.run/br/tst/labour-certificate/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "33.000.167/0001-01" }'
```

Returns `document_number`, `status` (`clear`, `debts` or `debts_secured`), `has_clearance_effect`, `status_label` (the certificate's title), `certificate_number` (e.g. `75794208/2026`), `issued_at` (ISO 8601, Brasília time), `valid_until` (`yyyy-mm-dd`, 180 days after issue), `company_name` (null when the certificate is issued without one), `total_cases`, `cases[]`, `pdf_url` (with `include_pdf`) and `checked_at`.

Each `cases[]` entry is `{ case_number, court, region, office, debt_condition }`: the CNJ case number, the regional labour court (`TRT 01ª Região`), its number, the labour court (vara) when the certificate names it, and `unsecured`, `secured` (by a deposit, a freeze or an attachment of enough assets) or `suspended`.

<Note>
  `debts_secured` is the certificate the court titles *positiva com efeito de
  negativa*: the company has labour debts, but every one is secured or
  suspended, so the certificate has the legal effect of a clearance, which is
  what `has_clearance_effect` says. Every valid CNPJ gets a certificate: there
  is no not-found.
</Note>

<Note>
  Each request issues a new certificate from the court, with its own number,
  valid for 180 days. This lookup can take longer than a typical request. It is
  an [async job](/async-jobs). By default the request waits inline and returns
  `{ data }`, or you can poll / use a `callback_url`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>