Check job title eligibility

Checks whether Remote can employ the given job title and role for this employment, and
returns the verdict without changing anything.

Call this before submitting contract details. The verdict tells you whether the
submission will succeed, be rejected, need a risk acknowledgement, or place the
employment into a human review; and the returned check_id lets the submission reuse
the verdict instead of recalculating it.

Calling this repeatedly with the same job title and role answers is cheap: the recorded
check is reused. Changing any of them produces a fresh verdict.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page. See Authorization for customers.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage employments (employments)-Manage employments (employment:write)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Employment ID

Body Params

Job title eligibility check params

string

The job title to check. Defaults to the employment's current job title when omitted.

string

A description of the role. Required when the job title alone is inconclusive; the response says so.

string
enum

Whether the role requires working onsite.

Allowed:
string
enum

Whether the role requires a professional license.

Allowed:
Responses

Callback
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json