REremote-com
Subscriptions

List contractor of record (COR) termination requests

Lists Contractor of Record termination requests for your company, optionally filtered by employment and status.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.

Scopes

Any one of the scopes in a token type's row is enough. all:read and all:write work too.

Token typeCategoryRead only ScopeWrite only Scope (read access implicit)
Company-scoped access tokenManage employments (employments)View employments (employment:read)Manage employments (employment:write)
Company-scoped access token (assertion)Manage employments (employments)View employments (employment:read)Manage employments (employment:write)
Customer API tokenManage employments (employments)View employments (employment:read)Manage employments (employment:write)
get/v1/contractors/cor-termination-requests

Request

  • Base URL
    https://gateway.remote.com
  • URL
    https://gateway.remote.com/v1/contractors/cor-termination-requests
  • Auth
    • OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: https://gateway.remote.com/company.manage
    • or OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: employment:read
    • or OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: all:read
    • or OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: all:write
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token scopes: employment:read
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token scopes: all:read
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token scopes: all:write
    • or HTTP bearer

Query parameters

employment_idstring uuid

A unique identifier in UUID v4 format.

Example:663e0b79-c893-45ff-a1b2-f6dcabc098b5

Filter termination requests by employment ID.

status'initiated' | 'executed' | 'cancelled'

Filter termination requests by status.

pageinteger

Starts fetching records after the given page

page_sizeinteger

Number of items per page

Response

Success

Example response

{
  "current_page": 1,
  "termination_requests": [
    {
      "cancelled_at": null,
      "employment_deactivation_date": "2026-04-07",
      "employment_id": "c0a167b8-459d-4e96-9766-7a04c160892e",
      "executed_at": "2026-04-07T10:00:00Z",
      "id": "c0a167b8-459d-4e96-9766-7a04c160892e",
      "initiated_at": "2026-03-16T08:00:00Z",
      "status": "executed",
      "termination_date": "2026-03-16"
    }
  ],
  "total_count": 1,
  "total_pages": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.