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 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

Category	Read only Scope	Write only Scope (read access implicit)
Manage 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: HTTP bearer and OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, employment:read, employment:write, employments, all:write, all:read)

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 65 revisions of this API.