Skip to main content
GET
List the company's reasons

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Query Parameters

merchant_id
string<uuid>

Optional merchant to scope to. Admins and sub-merchant operators only; other callers always use their token's merchant.

Example:

"28106cba-1c27-4e53-b149-32113e5e8e31"

type
enum<string>

Only one type: decision (reject / withdraw reasons) or position_status (the reason_id of a position lifecycle change). Left out: both, without a type the company has switched off.

Available options:
decision,
position_status
kind
enum<string>

Decision reasons only: reject or withdraw.

Available options:
reject,
withdraw
include_archived
enum<string>
default:false

true: also the archived reasons, which past decisions keep but are no longer offered.

Available options:
true,
false
Example:

"false"

language
string
default:en

Language of a decision reason's display_label (default en).

Pattern: ^[a-z]{2}$
Example:

"en"

Response

The reasons.

data
object[]
required

Decision reasons by kind, then position status reasons, each in the company's order.