TST Labour-Debt Certificate (CNDT)

Issue Brazil's labour-debt certificate (Certidão Negativa de Débitos Trabalhistas) for a company by CNPJ, live from the Tribunal Superior do Trabalho: clear, debts, or debts_secured (every debt secured or suspended, with the legal effect of a clearance), the certificate number, issue time and validity, and each labour case with its court and whether the debt is secured. Optionally the official PDF. Async job; most calls finish inline.

Supports async delivery: set Prefer: wait=N for an inline result, pass callback_url to receive a POST when ready, or poll GET /jobs/{id}.

post/br/tst/labour-certificate/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/br/tst/labour-certificate/v1
Auth: HTTP bearer

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Preferstring

Example:wait=30

Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.

Request body

document_numberstring required

CNPJ de la empresa, con o sin puntuación, p. ej. 33.000.167/0001-01. Solo empresas: un CPF no se acepta.

include_pdfboolean

Si es true, la respuesta incluye pdf_url, el enlace a la certidão oficial en PDF (opcional).

callback_urlstring uri

POST the job result here when it finishes.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.