Integrations
Job Title Screenings

Create a job title screening

Changed on

Screens a batch of job titles for EOR hiring eligibility, before any company or employment exists. Callable with an integration (client credentials) token or a company-scoped token issued through the integration; screenings belong to the integration either way. Returns immediately with a processing screening — poll the show endpoint until status is completed. Verdicts are advisory and reflect the eligibility policy at the time of screening: the policy evolves over time and the same checks re-run during onboarding, so the onboarding outcome may differ from an earlier screening verdict for the same title.

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.
  • Client credentials access token (OAuth2ClientCredentials) — obtained through the Client Credentials flow or the Refresh Token flow. See Authentication for partners.
post/v1/job-title-screenings

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/job-title-screenings
  • Auth: OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token) and OAuth 2 (client credentials, token URL /auth/oauth2/token)

Request body

Example request

{
  "items": [
    {
      "job_title": "Nurse"
    },
    {
      "job_title": "Security Guard",
      "role_description": "Guards the office building at night",
      "role_is_onsite": "yes",
      "role_requires_license": "no"
    }
  ]
}

Response

Accepted

Example response

{
  "data": {
    "job_title_screening": {
      "created_at": "2026-01-01T00:00:00Z",
      "id": "0073fcb5-b669-4e4a-b963-2a47744e75a1",
      "items": [
        {
          "job_title": "Nurse",
          "role_description": null,
          "role_is_onsite": null,
          "role_requires_license": null,
          "verdict": "eligible"
        }
      ],
      "status": "completed",
      "updated_at": "2026-01-01T00:01:00Z"
    }
  }
}

Changes