Get Refusal Reasons

GET 
/v1/open-api/reason-for-refusal/all

List the company's refusal (lost) reasons, ordered by orders. A lead moved to a FAILED pipeline stage carries one of them as reasonsForRefusal, and they are the allowed values of the reasonsForRefusalIds lead filter.

When the company setting SAVE_LEAD_WITHOUT_REASON is enabled, the list starts with a synthetic entry { "id": 0, "value": "Sababsiz", "orders": 0 } meaning "no reason given". It is not a stored reason — a lead saved without a reason references id 0.

Requires grant PERMISSION_OPEN_API_LEAD:READ.

Responses

200

All refusal reasons of the company.

401

Invalid, revoked or expired token (401) — also returned when the connection was revoked or the company is blocked.

Produced by the authentication filter, so the body is a reduced envelope: no error, no requestId, and errors is null rather than []. Every cause yields the same fixed English message.

403

The token lacks the required permission:scope grant (403).

429

Rate limit of 60 requests/minute exceeded (429). Like 401, this comes from the authentication filter: reduced envelope, fixed English message, no error object and no Retry-After header.