Deel

aid: deel
url: https://raw.githubusercontent.com/api-evangelist/deel-com/refs/heads/main/apis.yml
apis:
  - aid: deel:deel-core-api
    name: Deel Core API
    tags:
      - HR
      - Workforce
      - People
      - Contracts
      - Invoices
    humanURL: https://developer.deel.com/api/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/introduction
        type: Documentation
      - url: https://developer.deel.com/api/quickstart
        type: GettingStarted
      - url: https://developer.deel.com/api/authentication
        type: Authentication
      - url: openapi/deel-core-api-openapi.yml
        type: OpenAPI
      - url: json-schema/deel-contract-schema.json
        type: JSONSchema
      - url: json-schema/deel-person-schema.json
        type: JSONSchema
      - url: json-ld/deel-com-context.jsonld
        type: JSONLD
    description: >-
      Core organizational, contract, and people APIs covering organizations, legal entities, departments, groups,
      managers, cost centers, contracts (IC, EOR, COR, Global Payroll), invoice adjustments, lookups (countries,
      currencies, job titles, seniorities), magic links, tasks, and custom fields. Requires a bearer Organization or
      Personal API token (scoped permissions per endpoint).
  - aid: deel:deel-eor-api
    name: Deel Employer of Record (EOR) API
    tags:
      - HR
      - EOR
      - Employer of Record
      - Hiring
      - Compliance
      - Workforce
    humanURL: https://developer.deel.com/api/employer-of-record/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/employer-of-record/introduction
        type: Documentation
      - url: https://developer.deel.com/api/employer-of-record/employment-cost-calculator
        type: Documentation
      - url: https://developer.deel.com/api/employer-of-record/hiring
        type: Documentation
      - url: https://developer.deel.com/api/employer-of-record/accept-quote
        type: Documentation
      - url: openapi/deel-eor-api-openapi.yml
        type: OpenAPI
      - url: json-schema/deel-eor-contract-schema.json
        type: JSONSchema
    description: >-
      Employer of Record APIs for compliantly hiring full-time employees in 100+ countries where the client lacks a
      local entity. Surfaces include EOR cost calculator, three-party EOR contract quote/sign flow, hiring guides by
      country, EOR amendments, terminations, offboarding, worker compliance/benefits/documents/banks/payslips, and
      country-specific benefits enrollment.
  - aid: deel:deel-contractors-api
    name: Deel Contractors API
    tags:
      - HR
      - Contractors
      - Independent Contractors
      - Invoicing
      - Timesheets
      - Workforce
    humanURL: https://developer.deel.com/api/contractors/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/contractors/introduction
        type: Documentation
      - url: https://developer.deel.com/api/contractors/invoice-adjustments
        type: Documentation
      - url: https://developer.deel.com/api/contractors/timesheets
        type: Documentation
      - url: openapi/deel-contractors-api-openapi.yml
        type: OpenAPI
    description: >-
      Independent Contractor (IC), Pay-As-You-Go, Milestone, and COR (Contractor of Record) APIs covering IC contract
      creation, amendments, bulk signing, timesheets, milestones, IC invoicing taxes, off-cycle payments, bonuses,
      expense reimbursements, and contractor onboarding/offboarding.
  - aid: deel:deel-global-payroll-api
    name: Deel Global Payroll API
    tags:
      - Payroll
      - Global Payroll
      - HR
      - Time Tracking
      - Payslips
      - Workforce
    humanURL: https://developer.deel.com/api/global-payroll/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/global-payroll/introduction
        type: Documentation
      - url: https://developer.deel.com/api/global-payroll/time-tracking
        type: Documentation
      - url: https://developer.deel.com/api/global-payroll/adjustments
        type: Documentation
      - url: openapi/deel-global-payroll-api-openapi.yml
        type: OpenAPI
      - url: json-schema/deel-payroll-event-schema.json
        type: JSONSchema
    description: >-
      Global Payroll APIs for direct employees on the client's own legal entities across 120+ countries. Covers payroll
      events/cycles, gross-to-net adjustments (bonuses, deductions, one-time payments, expense reimbursements), time
      tracking shifts, payslips/paystubs, and Global Payroll hiring.
  - aid: deel:deel-hris-api
    name: Deel HRIS API
    tags:
      - HRIS
      - HR
      - People
      - Time Off
      - SCIM
      - Identity
      - Workforce
    humanURL: https://developer.deel.com/api/hris/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/hris/introduction
        type: Documentation
      - url: https://developer.deel.com/api/scim-api/overview
        type: Documentation
      - url: https://developer.deel.com/api/hris-common-use-cases/sync-deel-users-to-identity-providers
        type: Documentation
      - url: openapi/deel-hris-api-openapi.yml
        type: OpenAPI
      - url: json-schema/deel-time-off-schema.json
        type: JSONSchema
    description: >-
      Unified HR Information System API covering all workers (IC, EOR, employee). Surfaces include people directory,
      working locations, time off (policies, requests, entitlements, events, work schedules), positions, employment
      information, departments, manager hierarchy, custom HR fields, and SCIM 2.0 user provisioning for Okta, Azure AD,
      and other IdPs.
  - aid: deel:deel-ats-api
    name: Deel ATS API
    tags:
      - ATS
      - Recruiting
      - Hiring
      - Candidates
      - Jobs
      - HR
    humanURL: https://developer.deel.com/api/ats-guides/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/ats-guides/introduction
        type: Documentation
      - url: https://developer.deel.com/api/ats-guides/getting-started
        type: Documentation
      - url: https://developer.deel.com/api/ats-guides/manage-jobs
        type: Documentation
      - url: https://developer.deel.com/api/ats-guides/manage-candidates-and-applications
        type: Documentation
      - url: https://developer.deel.com/api/ats-guides/webhooks
        type: Documentation
      - url: openapi/deel-ats-api-openapi.yml
        type: OpenAPI
    description: >-
      Applicant Tracking System API for managing the full recruiting pipeline — jobs and job postings, candidates,
      applications, attachments, offers, departments, locations, email templates, hiring members, employment types,
      application sources, tags, and reasons. End-to-end flow candidate-to-contract via the Deel Hire handoff.
  - aid: deel:deel-webhooks-api
    name: Deel Webhooks API
    tags:
      - Webhooks
      - Events
      - Notifications
      - HR
      - Payroll
    humanURL: https://developer.deel.com/api/webhooks/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/webhooks/introduction
        type: Documentation
      - url: https://developer.deel.com/api/webhooks/quickstart
        type: Documentation
      - url: https://developer.deel.com/api/webhooks/events
        type: Documentation
      - url: https://developer.deel.com/api/webhooks/simulations
        type: Documentation
      - url: openapi/deel-webhooks-api-openapi.yml
        type: OpenAPI
    description: >-
      Webhook management API and event catalog for real-time notifications across contracts, invoices, payroll, time
      off, EOR onboarding, ATS, and worker lifecycle events. Webhook payloads are HMAC-signed and can be simulated from
      the Developer Center without affecting production data.
  - aid: deel:deel-platform-extensions-api
    name: Deel Platform Extensions API
    tags:
      - Compliance
      - Background Checks
      - Immigration
      - Visas
      - Equipment
      - IT
      - Screenings
    humanURL: https://developer.deel.com/api/platform/introduction
    baseURL: https://api.letsdeel.com/rest/v2
    properties:
      - url: https://developer.deel.com/api/platform/screenings
        type: Documentation
      - url: https://developer.deel.com/api/platform/immigration
        type: Documentation
      - url: https://developer.deel.com/api/deel-it/getting-started/introduction
        type: Documentation
      - url: openapi/deel-platform-extensions-api-openapi.yml
        type: OpenAPI
    description: >-
      Specialized platform extensions covering background screenings (KYC/AML), immigration case management (visa types,
      business visa eligibility, work permits, right-to-work cases, document upload), and Deel IT (device provisioning,
      equipment assets, asset orders) for distributed workforce hardware management.
name: Deel
tags:
  - HR
  - Payroll
  - Global Payroll
  - EOR
  - Employer of Record
  - Contractors
  - HRIS
  - ATS
  - Workforce
  - Compliance
  - Immigration
  - Background Checks
  - Webhooks
  - IT
kind: contract
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
  - type: Portal
    url: https://www.deel.com
  - type: Documentation
    url: https://developer.deel.com/
  - type: Documentation
    name: API Reference
    url: https://developer.deel.com/reference
  - type: GettingStarted
    url: https://developer.deel.com/api/quickstart
  - type: Authentication
    url: https://developer.deel.com/api/authentication
  - type: Authentication
    name: OAuth2
    url: https://developer.deel.com/api/oauth
  - type: RateLimits
    url: https://developer.deel.com/api/rate-limits
  - type: Documentation
    name: Idempotency
    url: https://developer.deel.com/api/idempotency
  - type: BestPractices
    url: https://developer.deel.com/api/best-practices
  - type: Versioning
    url: https://developer.deel.com/api/api-versioning
  - type: Sandbox
    url: https://developer.deel.com/api/sandbox
  - type: Webhooks
    url: https://developer.deel.com/api/webhooks/introduction
  - type: Webhooks
    name: Webhook Events Catalog
    url: https://developer.deel.com/api/webhooks/events
  - type: Partner
    name: Deel App Store / Partners
    url: https://developer.deel.com/api/partners/introduction
  - type: Embedded
    name: Deel as a Service (Embedded)
    url: https://developer.deel.com/api/embedded/introduction
  - type: MCP
    name: Deel MCP Server
    url: https://developer.deel.com/mcp/introduction
  - type: Documentation
    name: MCP Connecting Clients
    url: https://developer.deel.com/mcp/connecting-clients
  - type: Documentation
    name: MCP Tools Reference
    url: https://developer.deel.com/mcp/reference/tools-reference
  - type: Community
    name: Stack by Deel
    url: https://stack.deel.com
  - type: Blog
    url: https://www.deel.com/blog/
  - type: Pricing
    url: https://www.deel.com/pricing/
  - type: StatusPage
    url: https://status.deel.com/
  - type: HelpCenter
    url: https://help.letsdeel.com/
  - type: ContactUs
    url: https://www.deel.com/contact-us/
  - type: LinkedIn
    url: https://www.linkedin.com/company/deel/
  - type: X
    url: https://x.com/deel
  - type: GitHubOrganization
    url: https://github.com/deel
  - type: Plans
    url: plans/deel-com-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/deel-com-rate-limits.yml
  - type: FinOps
    url: finops/deel-com-finops.yml
  - type: Features
    data:
      - Global payroll in 120+ countries with local compliance and tax handling
      - Employer of Record (EOR) in 100+ countries via Deel-owned local entities
      - Contractor management with IC, Pay-As-You-Go, milestone, and COR contract types
      - Pay workers in 150+ currencies including crypto (Bitcoin, Ethereum, USDC)
      - Unified HRIS across all worker types (employee, contractor, EOR)
      - Time off, time tracking, and work schedule management
      - SCIM 2.0 user provisioning for Okta, Azure AD, and other identity providers
      - ATS (Applicant Tracking System) with jobs, candidates, applications, offers, and pipeline tracking
      - Deel IT — device provisioning, MDM, and equipment lifecycle for distributed teams
      - Deel Mobility — in-house visa and immigration case management
      - Deel Engage — performance, learning, and 1:1 management
      - Background checks (KYC and AML screenings)
      - Bearer-token authentication with Organization and Personal token types and granular scopes
      - OAuth2 authentication for Deel App Store partner integrations
      - Date-based API versioning with documented endpoint lifecycle states
      - Rate limiting at 5 requests per second per organization (shared across tokens)
      - Idempotency keys on POST/PATCH via UUID v4 with 24-hour response cache
      - Webhooks with HMAC-SHA256 signatures and a no-code subscription manager
      - Webhook simulation in sandbox without affecting production data
      - Sandbox environment at api-sandbox.demo.deel.com with pre-populated test workers
      - Deel as a Service (Embedded) — partners embed EOR/IC workflows directly into their own products
      - Deel MCP Server for AI agent integration with Claude Code, Cursor, and other MCP clients
      - LLM-ready docs via .md page suffix and llms-full.txt aggregated documentation
      - Postman collection, Insomnia collection, and inline OpenAPI per endpoint
      - 2,000+ in-country experts plus AI-driven compliance logic
    sources:
      - https://www.deel.com/
      - https://developer.deel.com/api/introduction
      - https://developer.deel.com/api/authentication
      - https://developer.deel.com/api/rate-limits
      - https://developer.deel.com/api/sandbox
      - https://developer.deel.com/api/webhooks/introduction
      - https://developer.deel.com/api/partners/introduction
      - https://developer.deel.com/api/embedded/introduction
      - https://developer.deel.com/mcp/introduction
    updated: '2026-05-25'
created: '2026-05-25'
modified: '2026-05-25'
position: Consuming
description: >-
  Deel is a global workforce platform combining payroll, Employer of Record (EOR), independent contractor management,
  HRIS, ATS, IT/device management, immigration, and background screenings across 150+ countries. The Deel Public API and
  SCIM API expose the full worker lifecycle — hire, onboard, pay, manage time off, run payroll, terminate — through a
  REST surface at api.letsdeel.com/rest/v2 with bearer-token and OAuth2 authentication, a sandbox at
  api-sandbox.demo.deel.com, HMAC-signed webhooks, a Deel App Store for partner apps, an Embedded "Deel as a Service"
  model, and a public MCP server for AI agent integration. Deel has compliantly processed over $20B in global payroll
  for 40,000+ companies.
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com
    X: apievangelist
    url: https://apievangelist.com
specificationVersion: '0.16'