Remote

aid: remote-com
url: https://raw.githubusercontent.com/api-evangelist/remote-com/refs/heads/main/apis.yml
name: Remote
description: |
  Remote.com is a global employment platform that lets companies hire,
  pay, and manage employees and contractors in 90+ countries without
  setting up local entities. Remote owns in-country legal entities
  across its EOR footprint and runs its own global payroll and benefits
  infrastructure rather than reselling third-party providers. The
  platform layers a developer API, partner OAuth flows, webhooks, a
  CLI, language SDKs, an AI agent toolkit, and an official MCP server
  on top of these services so customers and partners can fully automate
  hiring, onboarding, payroll, benefits, time off, expenses, and
  offboarding.
image: https://remote.com/favicon.ico
humanURL: https://remote.com
baseURL: https://gateway.remote.com/v1
tags:
  - Global Payroll
  - EOR
  - Contractor Management
  - Contractor of Record
  - PEO
  - HRIS
  - Recruiting
  - Benefits
  - Employment
  - HR
  - Compliance
  - Workforce
  - MCP
  - AI Agents
created: '2026-05-25'
modified: '2026-05-25'
apis:
  - aid: remote-com:remote-companies-api
    name: Remote Companies API
    tags:
      - Companies
      - Compliance
      - SSO
      - Identity
    humanURL: https://developer.remote.com/reference/welcome-to-remote-api
    baseURL: https://gateway.remote.com/v1
    description: |
      Create and manage companies on Remote. Entry point for every
      Remote integration — partners use this API to provision new
      customer companies and obtain company-scoped access tokens. Also
      covers company managers, departments, legal entities, compliance
      profile, hiring eligibility reserves, SSO configuration, token
      identity, and magic-link generation.
    properties:
      - url: https://developer.remote.com/reference/welcome-to-remote-api
        type: Documentation
      - url: https://developer.remote.com/docs/creating-a-company
        type: Documentation
      - url: openapi/remote-companies-api-openapi.yml
        type: OpenAPI
      - url: json-schema/remote-company-schema.json
        type: JSONSchema
      - url: json-ld/remote-com-context.jsonld
        type: JSONLD
  - aid: remote-com:remote-employments-api
    name: Remote Employments API
    tags:
      - Employments
      - Onboarding
      - Offboarding
      - Contracts
      - Travel Letters
      - Work Authorization
    humanURL: https://developer.remote.com/docs/create-new-employment
    baseURL: https://gateway.remote.com/v1
    description: |
      Manage employment records across EOR, Global Payroll, and PEO
      models. Covers the full lifecycle — create, invite, onboard,
      sign contracts, amend contracts, run identity verification,
      file travel-letter and work-authorization requests, manage
      company structure, and offboard. Authoritative source of truth
      for every worker record on Remote.
    properties:
      - url: https://developer.remote.com/docs/create-new-employment
        type: Documentation
      - url: https://developer.remote.com/docs/employment-lifecycle-stages
        type: Documentation
      - url: https://developer.remote.com/docs/employment-statuses
        type: Documentation
      - url: openapi/remote-employments-api-openapi.yml
        type: OpenAPI
      - url: json-schema/remote-employment-schema.json
        type: JSONSchema
      - url: json-ld/remote-com-context.jsonld
        type: JSONLD
      - url: examples/remote-create-employment-example.json
        type: Example
  - aid: remote-com:remote-contractors-api
    name: Remote Contractors API
    tags:
      - Contractors
      - COR
      - Contractor of Record
      - Invoices
      - Misclassification
    humanURL: https://developer.remote.com/reference/welcome-to-remote-api
    baseURL: https://gateway.remote.com/v1
    description: |
      Manage contractor subscriptions across the Standard, Plus
      (indemnity), and Contractor-of-Record plans. Surfaces include
      contractor invoices, scheduled-invoice automation,
      contract-eligibility checks (powered by Remote's AI
      misclassification tooling), COR termination requests, and
      contractor currency catalogs.
    properties:
      - url: https://developer.remote.com/reference/welcome-to-remote-api
        type: Documentation
      - url: openapi/remote-contractors-api-openapi.yml
        type: OpenAPI
  - aid: remote-com:remote-payroll-billing-api
    name: Remote Payroll and Billing API
    tags:
      - Payroll
      - Billing
      - Incentives
      - Expenses
      - Payslips
      - FinOps
    humanURL: https://developer.remote.com/docs/quick-start-guide-2
    baseURL: https://gateway.remote.com/v1
    description: |
      Inspect payroll calendars, billing documents (with itemized
      breakdowns and PDF download), incentives (one-time bonuses and
      recurring incentives), expenses (with approve/decline/reimburse
      flows), payslips, and company billing currencies. The financial
      backbone of every Remote engagement.
    properties:
      - url: https://developer.remote.com/docs/quick-start-guide-2
        type: Documentation
      - url: https://developer.remote.com/docs/working-with-expenses
        type: Documentation
      - url: https://developer.remote.com/docs/working-with-incentives
        type: Documentation
      - url: openapi/remote-payroll-billing-api-openapi.yml
        type: OpenAPI
      - url: json-schema/remote-billing-document-schema.json
        type: JSONSchema
  - aid: remote-com:remote-time-attendance-api
    name: Remote Time and Attendance API
    tags:
      - Time Off
      - Leave
      - Timesheets
      - HRIS
    humanURL: https://developer.remote.com/docs/working-with-time-off
    baseURL: https://gateway.remote.com/v1
    description: |
      Manage time-off requests, leave policies, leave balances, and
      timesheets. Approve/decline/cancel flows for managers; submit
      and self-serve flows for employees. Every state change is also
      emitted via webhook events.
    properties:
      - url: https://developer.remote.com/docs/working-with-time-off
        type: Documentation
      - url: https://developer.remote.com/docs/leave-policies-summary
        type: Documentation
      - url: https://developer.remote.com/docs/working-with-timesheets
        type: Documentation
      - url: openapi/remote-time-attendance-api-openapi.yml
        type: OpenAPI
      - url: json-schema/remote-time-off-schema.json
        type: JSONSchema
      - url: examples/remote-create-timeoff-example.json
        type: Example
  - aid: remote-com:remote-benefits-api
    name: Remote Benefits API
    tags:
      - Benefits
      - Health
      - Pension
      - Renewals
    humanURL: https://developer.remote.com/docs/benefits-renewal
    baseURL: https://gateway.remote.com/v1
    description: |
      List localized benefit offers by country, attach offers to
      employments using JSON Schema forms, and respond to annual
      benefit-renewal requests. Backed by Remote's in-country
      benefits infrastructure.
    properties:
      - url: https://developer.remote.com/docs/benefits-renewal
        type: Documentation
      - url: openapi/remote-benefits-api-openapi.yml
        type: OpenAPI
  - aid: remote-com:remote-files-and-custom-fields-api
    name: Remote Files and Custom Fields API
    tags:
      - Files
      - Documents
      - Custom Fields
      - Countries
      - Cost Calculator
    humanURL: https://developer.remote.com/docs/working-with-files
    baseURL: https://gateway.remote.com/v1
    description: |
      Upload and download files attached to employments, companies,
      and expenses. Define and set customer-managed custom fields on
      companies and employments. List supported countries and their
      employment models. Estimate the loaded annual cost of hiring an
      employee in any country via the cost calculator.
    properties:
      - url: https://developer.remote.com/docs/working-with-files
        type: Documentation
      - url: https://developer.remote.com/docs/custom-fields
        type: Documentation
      - url: https://developer.remote.com/docs/working-with-countries
        type: Documentation
      - url: https://developer.remote.com/docs/employment-cost-estimation
        type: Documentation
      - url: openapi/remote-files-api-openapi.yml
        type: OpenAPI
      - url: examples/remote-cost-estimate-example.json
        type: Example
  - aid: remote-com:remote-oauth-api
    name: Remote OAuth 2.0 API
    tags:
      - OAuth
      - Authentication
      - Authorization
      - Partners
    humanURL: https://developer.remote.com/docs/authentication
    baseURL: https://gateway.remote.com
    description: |
      OAuth 2.0 endpoints used to obtain access tokens for the Remote
      API. Four supported flows — authorization code (customer apps
      and partners), client credentials (partners), JWT bearer
      assertion (partners acting for a specific company), and refresh
      token. Plus magic-link generation for passwordless employee
      sign-in.
    properties:
      - url: https://developer.remote.com/docs/authentication
        type: Documentation
      - url: https://developer.remote.com/docs/authorization-for-customers
        type: Documentation
      - url: https://developer.remote.com/docs/client-credentials-flow-for-partners
        type: Documentation
      - url: https://developer.remote.com/docs/authorization-method-oauth-assertion
        type: Documentation
      - url: https://developer.remote.com/docs/refresh-token-flow
        type: Documentation
      - url: openapi/remote-oauth-api-openapi.yml
        type: OpenAPI
      - url: examples/remote-oauth-token-exchange-example.json
        type: Example
  - aid: remote-com:remote-webhooks
    name: Remote Webhooks
    tags:
      - Webhooks
      - Events
      - AsyncAPI
    humanURL: https://developer.remote.com/docs/available-webhooks
    baseURL: https://gateway.remote.com
    description: |
      Remote emits webhook events for every meaningful state change
      across companies, employments, contractors, payroll, billing,
      time off, timesheets, benefits, identity verification, and SSO.
      Webhooks are signed with `X-Remote-Signature` and delivered to a
      customer-managed HTTPS endpoint. 90+ event types in total.
    properties:
      - url: https://developer.remote.com/docs/available-webhooks
        type: Documentation
      - url: https://developer.remote.com/docs/working-with-webhooks
        type: Documentation
      - url: https://developer.remote.com/docs/verifying-webhooks
        type: Documentation
      - url: asyncapi/remote-webhooks-asyncapi.yml
        type: AsyncAPI
      - url: examples/remote-employment-onboarding-completed-webhook-example.json
        type: Example
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/remote/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/remote-com-amend-contract-workflow.yml
        name: Remote Amend An Employment Contract
        summary: Submit a contract amendment for an employment and track it to a resolved state.
      - url: arazzo/remote-com-cancel-time-off-workflow.yml
        name: Remote Cancel A Time Off Request
        summary: Find an employment's approved time off request and cancel it.
      - url: arazzo/remote-com-country-leave-policy-workflow.yml
        name: Remote Look Up A Country Leave Policy
        summary: Confirm a country is supported, list its leave policies, and fetch one policy's detail.
      - url: arazzo/remote-com-create-incentive-workflow.yml
        name: Remote Create An Incentive
        summary: Create a bonus or commission incentive for an employment and confirm it.
      - url: arazzo/remote-com-employee-payslip-workflow.yml
        name: Remote Retrieve An Employee Payslip
        summary: Find an active employee by email, list their payslips, and fetch the latest payslip detail.
      - url: arazzo/remote-com-enroll-employee-benefits-workflow.yml
        name: Remote Enroll An Employee In Benefits
        summary: Read the benefit offers schema for an employment, select offers, and upsert the elections.
      - url: arazzo/remote-com-estimate-and-hire-workflow.yml
        name: Remote Estimate Cost Then Hire
        summary: Estimate the loaded cost of a hire, then create the employment once the budget is confirmed.
      - url: arazzo/remote-com-hire-eor-employee-workflow.yml
        name: Remote Hire An EOR Employee
        summary: Create an EOR employment, confirm it, and invite the worker to self-serve onboarding.
      - url: arazzo/remote-com-offboard-employee-workflow.yml
        name: Remote Offboard An Employee
        summary: Submit an offboarding for an employment and confirm it entered review.
      - url: arazzo/remote-com-onboard-company-workflow.yml
        name: Remote Onboard A New Company
        summary: Create a company, then add an initial department and an admin manager under it.
      - url: arazzo/remote-com-request-time-off-workflow.yml
        name: Remote Request And Resolve Time Off
        summary: Create a time off request, confirm it, and approve or decline it.
      - url: arazzo/remote-com-review-billing-document-workflow.yml
        name: Remote Review A Billing Document
        summary: Find the latest issued billing document, confirm it, and pull its line-item breakdown.
      - url: arazzo/remote-com-review-timesheet-workflow.yml
        name: Remote Review A Timesheet
        summary: Find a submitted timesheet for an employment and approve it or send it back.
      - url: arazzo/remote-com-schedule-contractor-invoices-workflow.yml
        name: Remote Schedule Recurring Contractor Invoices
        summary: Bulk-create scheduled contractor invoices, then confirm the first schedule.
      - url: arazzo/remote-com-screen-contractor-workflow.yml
        name: Remote Screen A Contractor For Misclassification
        summary: Run a contractor misclassification check, then act on the recommendation.
      - url: arazzo/remote-com-submit-expense-workflow.yml
        name: Remote Submit And Resolve An Expense
        summary: Create an expense, confirm it, and approve or decline it.
      - url: arazzo/remote-com-terminate-contractor-workflow.yml
        name: Remote Terminate A Contractor Of Record Engagement
        summary: Create a COR termination request, confirm it, and submit the termination.
  - url: https://remote.com
    type: WebSite
  - url: https://developer.remote.com
    type: DeveloperPortal
  - url: https://developer.remote.com/llms.txt
    type: LLMSText
  - url: https://developer.remote.com/docs/changelogs
    type: ChangeLog
  - url: https://remote.com/status
    type: StatusPage
  - url: https://trust.remote.com
    type: Security
  - url: https://remote.com/pricing
    type: Pricing
  - url: https://remote.com/blog
    type: Blog
  - url: https://support.remote.com
    type: Support
  - url: https://remote.com/legal/terms
    type: TermsOfService
  - url: https://remote.com/legal/privacy
    type: Privacy
  - url: https://remote.com/careers
    type: Careers
  - url: https://twitter.com/remote
    type: Twitter
  - url: https://www.linkedin.com/company/remote-com
    type: LinkedIn
  - url: https://github.com/remoteoss
    type: GitHub
  - url: plans/remote-com-plans-pricing.yml
    type: Plans
  - url: rate-limits/remote-com-rate-limits.yml
    type: RateLimits
  - url: finops/remote-com-finops.yml
    type: FinOps
  - url: rules/remote-com-rules.yml
    type: SpectralRules
  - url: vocabulary/remote-com-vocabulary.yml
    type: Vocabulary
  - url: review.yml
    type: Review
  - url: https://github.com/remoteoss/remote-cli
    type: CLI
    description: Official Remote.com CLI for managing companies and employees from the terminal.
  - url: https://github.com/remoteoss/ai-agent-toolkit
    type: SDK
    description: '@remoteoss/ai-agent-toolkit — TypeScript library exposing 34+ Remote tools to LangChain and MCP-based AI agents.'
  - url: https://github.com/remoteoss/remote-flows
    type: SDK
    description: >-
      @remoteoss/remote-flows — React SDK providing embedded employment flows (Cost Calculator, Onboarding, Amendment,
      Termination).
  - url: https://github.com/remoteoss/json-schema-form
    type: SDK
    description: '@remoteoss/json-schema-form — JavaScript library that renders Remote''s per-country JSON Schema forms.'
  - url: https://github.com/remoteoss/react-url-modal
    type: SDK
    description: react-url-modal — Remote''s URL-backed modal state library for React.
  - url: https://github.com/remoteoss/remote-for-ai
    type: Integration
    description: Official Remote-for-AI plugin marketplace (Claude Code, Cursor, Codex, Gemini CLI) shipping the Remote MCP server.
  - url: https://developer.remote.com/docs/introduction-to-remote-mcp
    type: MCP
    description: Remote.com MCP server for AI agents — OAuth 2.0, scoped capabilities, PII protections.
integrations:
  - name: Workday
    type: HRIS
    url: https://remote.com/integrations
  - name: HiBob
    type: HRIS
    url: https://remote.com/integrations
  - name: BambooHR
    type: HRIS
    url: https://remote.com/integrations
  - name: Personio
    type: HRIS
    url: https://remote.com/integrations
  - name: Merge
    type: Unified API
    url: https://developer.remote.com/docs/build-with-merge
useCases:
  - name: Hire abroad without an entity
    description: Use the EOR API to onboard an employee in any of 90+ countries through Remote's local entity.
  - name: Run global payroll
    description: Use the Global Payroll API to deliver compliant payroll across the customer's owned entities.
  - name: Pay contractors compliantly
    description: Issue localized contracts, approve invoices, and pay contractors via the Contractors API.
  - name: Eliminate misclassification risk
    description: Run pre-hire contractor-vs-employee eligibility checks via the Contract Eligibility endpoint.
  - name: Automate offboarding
    description: Use the Employments API offboarding endpoints to submit, review, and complete employee separations.
  - name: Embed Remote in your product
    description: Use the @remoteoss/remote-flows React SDK to embed Cost Calculator, Onboarding, Amendment, and Termination flows.
  - name: Drive Remote from an AI agent
    description: >-
      Use the Remote MCP server or the @remoteoss/ai-agent-toolkit to let Claude, Cursor, Codex, and Gemini act on
      Remote data with OAuth-scoped permissions.
solutions:
  - id: global-hiring
    name: Global Hiring
    description: End-to-end automated hiring across 90+ countries via EOR.
  - id: global-payroll
    name: Global Payroll
    description: Compliant payroll across customer-owned entities.
  - id: contractor-management
    name: Contractor Management
    description: Localized contracts, invoice approval, and payment for independent contractors.
  - id: us-peo
    name: US PEO
    description: Co-employment in the United States with statutory benefits and compliance.
  - id: equity
    name: Equity Administration
    description: Tax-aware equity grants and program management.
  - id: recruit
    name: Recruit
    description: AI-powered candidate sourcing and applicant tracking across 800m+ profiles.
  - id: ai-agents
    name: AI Agents
    description: Official MCP server and AI Agent Toolkit so AI agents can act on Remote with OAuth-scoped permissions.
features:
  - 90+ countries supported for EOR
  - In-house legal and payroll teams (not outsourced)
  - SOC 2 Type 2 and ISO 27001 certified
  - 300 requests / minute per company API quota
  - Sandbox environment at remote-sandbox.com
  - OAuth 2.0 (authorization code, client credentials, assertion, refresh)
  - JSON Schema forms for per-country localization
  - Signed webhooks (X-Remote-Signature)
  - Official MCP server with OAuth-scoped permissions
  - TypeScript AI Agent Toolkit (34+ tools)
  - React Embedded Flows SDK (Cost Calculator, Onboarding, Amendment, Termination)
  - Shell-based remote-cli for terminal use
  - 12 supported billing currencies
  - LLMs.txt index for AI-discoverable docs