Remote Employment Contracts API

View active and pending employment contracts

Business capability
HR Operations Management BC-300.70

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /employments/{employment_id}/contracts List an employee's contracts · List Employment Contracts #
Ask an LLM
“What contracts has an employee had with us over time?”
“How do I see every contract version for an employment?”
Tell an agent
List the contracts for employment {employment_id}.
Show the contract history of employment {employment_id}.
GET /employments/{employment_id}/contracts/pending_changes See pending contract changes for an employee · Get Pending Contract Changes #
Ask an LLM
“Are there contract changes waiting to take effect for an employee?”
“Which upcoming contract changes haven't been applied yet?”
Tell an agent
Show pending contract changes for employment {employment_id}.
Check what contract updates are queued for employment {employment_id}.

Documentation

📖
Documentation
https://developer.remote.com/reference/welcome-to-remote-api
📖
Documentation
https://developer.remote.com/docs/creating-a-company
📖
Documentation
https://developer.remote.com/docs/create-new-employment
📖
Documentation
https://developer.remote.com/docs/employment-lifecycle-stages
📖
Documentation
https://developer.remote.com/docs/employment-statuses
📖
Documentation
https://developer.remote.com/docs/quick-start-guide-2
📖
Documentation
https://developer.remote.com/docs/working-with-expenses
📖
Documentation
https://developer.remote.com/docs/working-with-incentives
📖
Documentation
https://developer.remote.com/docs/working-with-time-off
📖
Documentation
https://developer.remote.com/docs/leave-policies-summary
📖
Documentation
https://developer.remote.com/docs/working-with-timesheets
📖
Documentation
https://developer.remote.com/docs/benefits-renewal
📖
Documentation
https://developer.remote.com/docs/working-with-files
📖
Documentation
https://developer.remote.com/docs/custom-fields
📖
Documentation
https://developer.remote.com/docs/working-with-countries
📖
Documentation
https://developer.remote.com/docs/employment-cost-estimation
📖
Documentation
https://developer.remote.com/docs/authentication
📖
Documentation
https://developer.remote.com/docs/authorization-for-customers
📖
Documentation
https://developer.remote.com/docs/client-credentials-flow-for-partners
📖
Documentation
https://developer.remote.com/docs/authorization-method-oauth-assertion
📖
Documentation
https://developer.remote.com/docs/refresh-token-flow

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/remote-com:remote-com-employment-contracts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

remote-com-employment-contracts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Remote Employments Employment Contracts API
  description: 'Create and manage employment records across the EOR, Global Payroll, and

    PEO employment models on Remote.com. Endpoints cover the full employment

    lifecycle — onboarding, contract management, contract amendments,

    employment status transitions, identity verification, travel letters,

    work-authorization requests, and offboarding.


    Every Remote customer hiring through the platform owns one employment

    record per worker. This API is the authoritative source for that record.'
  version: '2026-05-22'
  contact:
    name: Remote API Support
    url: https://support.remote.com/
  x-logo:
    url: https://remote.com/favicon.ico
servers:
- url: https://gateway.remote.com/v1
  description: Production
- url: https://gateway.remote-sandbox.com/v1
  description: Sandbox
security:
- BearerAuth: []
tags:
- name: Employment Contracts
  description: View active and pending employment contracts
paths:
  /employments/{employment_id}/contracts:
    parameters:
    - $ref: '#/components/parameters/EmploymentIdPath'
    get:
      summary: List Employment Contracts
      operationId: listEmploymentContracts
      tags:
      - Employment Contracts
      responses:
        '200':
          description: Contracts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmploymentContractList'
  /employments/{employment_id}/contracts/pending_changes:
    parameters:
    - $ref: '#/components/parameters/EmploymentIdPath'
    get:
      summary: Get Pending Contract Changes
      operationId: getPendingContractChanges
      tags:
      - Employment Contracts
      responses:
        '200':
          description: Pending changes.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  schemas:
    EmploymentContractList:
      type: object
      properties:
        data:
          type: object
          properties:
            employment_contracts:
              type: array
              items:
                $ref: '#/components/schemas/EmploymentContract'
    EmploymentContract:
      type: object
      properties:
        id:
          type: string
          format: uuid
        employment_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
          - draft
          - pending_signature
          - active
          - terminated
        contract_type:
          type: string
          enum:
          - indefinite
          - fixed_term
        currency_code:
          type: string
        annual_gross_salary:
          type: integer
          description: Amount in smallest currency unit.
        weekly_hours:
          type: number
  parameters:
    EmploymentIdPath:
      name: employment_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT