Remote 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, signed webhooks, a CLI, language SDKs, an AI agent toolkit, and an official MCP server on top of these services so customers and partners can automate hiring, onboarding, payroll, benefits, time off, expenses, and offboarding end-to-end.
URL: Visit APIs.yml
Run: Capabilities Using Naftiko
- 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
| Environment | API Base URL | UI |
|---|---|---|
| Production | https://gateway.remote.com/v1 |
https://remote.com |
| Sandbox | https://gateway.remote-sandbox.com/v1 |
https://remote-sandbox.com |
| Partners Sandbox | https://gateway.partners.remote-sandbox.com/v1 |
https://partners.remote-sandbox.com |
| Flow | Used By | Result |
|---|---|---|
| Authorization Code | Customer apps and partners | Company-scoped access token (+ refresh token) |
| Client Credentials | Partners | Partner-scoped access token |
| JWT Bearer Assertion | Partners acting for a specific company | Company-scoped access token |
| Refresh Token | All clients | New access token |
| Magic Link | Users and employees | Single-use passwordless sign-in URL |
All API calls use Authorization: Bearer {access_token}. See openapi/remote-oauth-api-openapi.yml.
- 300 authenticated requests per 60-second window, applied per company (shared across every token belonging to the same company).
- Response headers:
x-ratelimit-count,x-ratelimit-remaining,x-ratelimit-reset(ms until window reset). - Throttling returns HTTP 429 with body
{"errors": {"detail": "Customer rate-limit exceeded."}}. - Full policy in rate-limits/remote-com-rate-limits.yml.
| Plan | Monthly Price | Notes |
|---|---|---|
| Recruit | from $199 / month | AI candidate sourcing, 800m+ profiles |
| Employer of Record (Monthly) | $699 / employee / month | 90+ countries, no entity required |
| Employer of Record (Annual) | $599 / employee / month | 14% savings vs monthly |
| Global Payroll | $29 / employee / month | + entity implementation fee + per-payroll delivery fee |
| Contractor Management (Standard) | $29 / contractor / month | Localized contracts, invoice approval |
| Contractor Management (Plus) | $99 / contractor / month | Adds $100k indemnity protection |
| Contractor of Record | from $325 / contractor / month | Uncapped indemnity, IP transfer |
| PEO (US) | from $99 / employee / month | US-only co-employment |
| Equity | from $39 / month | Equity grants administration |
| HR Management (HRIS) — Free | $0 | Free for direct employees on Remote |
| HR Management — Plus | $12 / employee / month | Advanced HRIS features |
Discounts: 15% for startups; 15% for social-purpose organizations. 12 billing currencies supported. Full plans in plans/remote-com-plans-pricing.yml.
Create and manage companies on Remote — the entry point for every integration. Includes managers, departments, legal entities, compliance profile and hiring-eligibility reserves, SSO configuration, token identity, and magic-link generation.
Human URL: https://developer.remote.com/reference/welcome-to-remote-api
- Documentation — Welcome
- Documentation — Company Creation
- OpenAPI
- JSON Schema — Company
- JSON-LD
- Naftiko Capability — Companies
Manage employment records across EOR, Global Payroll, and PEO models — create, invite, onboard, sign contracts, amend contracts, run identity verification, file travel-letter and work-authorization requests, manage company structure, and offboard.
Human URL: https://developer.remote.com/docs/create-new-employment
- Documentation — Create Employment
- Documentation — Employment Lifecycle Stages
- Documentation — Employment Statuses
- OpenAPI
- JSON Schema — Employment
- Naftiko Capability — Employments
- Example — Create Employment
Manage contractor subscriptions across the Standard, Plus (indemnity), and Contractor-of-Record plans. Covers contractor invoices, scheduled-invoice automation, contract-eligibility checks (powered by Remote's AI misclassification tooling), COR termination requests, and contractor currency catalogs.
Human URL: https://developer.remote.com/reference/welcome-to-remote-api
Inspect payroll calendars, billing documents (itemized breakdowns + PDF), incentives, expenses, payslips, and company billing currencies. The financial backbone of every Remote engagement.
Human URL: https://developer.remote.com/docs/quick-start-guide-2
- Documentation — Working With Expenses
- Documentation — Incentives
- OpenAPI
- JSON Schema — Billing Document
- Naftiko Capability — Payroll & Billing
- Naftiko Capability — Expenses
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 emitted via webhook.
Human URL: https://developer.remote.com/docs/working-with-time-off
- Documentation — Time Off
- Documentation — Leave Policies
- Documentation — Timesheets
- OpenAPI
- JSON Schema — Time Off
- Naftiko Capability — Time Off
- Naftiko Capability — Timesheets
- Example — Create Time Off
List localized benefit offers by country, attach offers to employments using JSON Schema forms, and respond to annual benefit-renewal requests.
Human URL: https://developer.remote.com/docs/benefits-renewal
Upload and download files; define and set customer-managed custom fields on companies and employments; list supported countries; estimate the loaded annual cost of hiring an employee in any country.
Human URL: https://developer.remote.com/docs/working-with-files
- Documentation — Files
- Documentation — Custom Fields
- Documentation — Countries
- Documentation — Cost Estimation
- OpenAPI
- Naftiko Capability — Cost Calculator
- Example — Cost Estimate
OAuth 2.0 endpoints — authorization code, client credentials, JWT bearer assertion, and refresh token flows. Plus magic-link generation for passwordless employee sign-in.
Human URL: https://developer.remote.com/docs/authentication
- Documentation — Authentication
- Documentation — Customer Authorization
- Documentation — Client Credentials (Partners)
- Documentation — JWT Assertion
- Documentation — Refresh Token
- OpenAPI
- Naftiko Capability — OAuth
- Example — Token Exchange
Remote emits 90+ signed webhook events covering companies, employments, contractors, payroll, billing, time off, timesheets, benefits, identity verification, and SSO. All events POST a signed JSON envelope to a customer-managed HTTPS endpoint and must be verified using the X-Remote-Signature header.
Human URL: https://developer.remote.com/docs/available-webhooks
- Documentation — Available Webhooks
- Documentation — Working With Webhooks
- Documentation — Verifying Webhooks
- AsyncAPI
- Example — onboarding.completed Webhook
| Tool | Package | Repo |
|---|---|---|
| Remote CLI | curl ... install.sh | sh (Shell binary) |
remoteoss/remote-cli |
| AI Agent Toolkit | @remoteoss/ai-agent-toolkit (npm) |
remoteoss/ai-agent-toolkit |
| Remote Flows (React Embedded SDK) | @remoteoss/remote-flows (npm) |
remoteoss/remote-flows |
| JSON Schema Form | @remoteoss/json-schema-form (npm) |
remoteoss/json-schema-form |
| react-url-modal | @remoteoss/react-url-modal (npm) |
remoteoss/react-url-modal |
| Remote MCP / Remote-for-AI plugin | Claude Code, Cursor, Codex, Gemini CLI | remoteoss/remote-for-ai |
| Remote.com MCP server | OAuth 2.0; PII-aware | Docs |
Workday · HiBob · BambooHR · Personio · Merge unified-API.
Global Hiring · Global Payroll · Contractor Management · US PEO · Equity Administration · Recruit · AI Agents.
- Status: remote.com/status
- Security & Trust: trust.remote.com — SOC 2 Type 2, ISO 27001
- Changelog: developer.remote.com/docs/changelogs
- Support: support.remote.com
- LLMs.txt: developer.remote.com/llms.txt — AI-discoverable index of every documentation page and OpenAPI operation
- GitHub: github.com/remoteoss
| Artifact | Path |
|---|---|
| Plans (API Commons Plans 0.1) | plans/remote-com-plans-pricing.yml |
| Rate Limits (API Commons Rate Limits 0.1) | rate-limits/remote-com-rate-limits.yml |
| FinOps (FOCUS-aligned) | finops/remote-com-finops.yml |
| JSON-LD context | json-ld/remote-com-context.jsonld |
| Spectral ruleset | rules/remote-com-rules.yml |
| Vocabulary | vocabulary/remote-com-vocabulary.yml |