Skip to main content
GET
Get merchant status

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"

Response

The merchant status snapshot.

profile_id
string
required

The calling user's profile id (auth user id), taken from the JWT.

Example:

"9b2c1e54-7a3d-4f8e-9c10-2b6a4d5e7f01"

default_merchant_id
string | null
required

The caller's home merchant id pinned in the JWT (app_metadata.merchant_id). Null if the token carries no merchant.

Example:

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

merchant_id
string
required

The merchant this status is scoped to — the default_merchant_id unless an admin / sub-merchant operator overrode it via the merchant_id query param.

Example:

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

credits_interview_monthly
number | null
required

Remaining monthly interview credits.

Example:

8

credits_interview_monthly_limit
number | null
required

Monthly interview-credit allowance for the current plan.

Example:

10

credits_interview_extra
number | null
required

Extra (top-up) interview credits available on top of the monthly allowance.

Example:

25

credits_interview_single
number | null
required

Single-position interview credits available.

Example:

0

definitions_active
number | null
required

Count of active interview + position definitions.

Example:

4

interviews_without_credits
number
required

Completed interviews that have not yet consumed a credit.

Example:

2

interviews_undecided
number
required

Completed interviews awaiting a recruiter decision.

Example:

3

contact_requests_open
number
required

Open contact requests from candidates (candidate_contact_request with status open).

Example:

1

interviews_ongoing
number
required

Interviews currently in progress (coach_status = started).

Example:

1

interview_results
number
required

Total non-archived interview results for the merchant.

Example:

137

candidates
number
required

Total candidates (non-archived profile_interview rows) for the merchant.

Example:

212

candidates_history
number[]
required

Daily new-candidate counts for the last 14 days, most recent first.

Example:
interview_result_history
number[]
required

Daily new-interview-result counts for the last 14 days, most recent first.

Example:
subscription_type
string | null
required

Subscription plan name (e.g. Free, Starter, Growth, Special).

Example:

"Growth"

subscription_status
string | null
required

Subscription status (e.g. active, past_due, canceled). Null when no subscription.

Example:

"active"

invitations_sent
number
required

Interview invitations sent during the current subscription period.

Example:

18

invitations_limit
number | null
required

Maximum invitations allowed this period (4x available credits). Null for unlimited (Special) plans.

Example:

40

invitations_available
number | null
required

Remaining invitations this period. Null for unlimited (Special) plans.

Example:

22

tasks_open
number

Your own open tasks (merchant_task assigned to you, status open). Present while the tasks switch is on.

Example:

4

document_requests_pending
number

Your own document requests that need you: received and not reviewed yet, or open past their due date (at most 50 are counted). Present while the document_requests switch is on.

Example:

2

duplicates_pending
number

Possible duplicate candidate pairs waiting for a decision (status open) that you can see. Present while the duplicate_detection switch is on.

Example:

3