aid: factorial-hr url: https://raw.githubusercontent.com/api-evangelist/factorial-hr/refs/heads/main/apis.yml apis: - aid: factorial:factorial-webhooks-api name: Factorial Webhooks API tags: - HR - Webhooks - Events humanURL: https://apidoc.factorialhr.com/docs/manage-webhooks properties: - url: https://apidoc.factorialhr.com/docs/manage-webhooks type: Documentation - url: https://apidoc.factorialhr.com/docs/webhooks-policies type: Documentation - url: https://apidoc.factorialhr.com/docs/webhooks-what type: Documentation - url: https://apidoc.factorialhr.com/docs/webhook-attendance-clock-in type: Documentation - url: json-schema/factorial-webhook-subscription-schema.json type: JSONSchema description: >- Subscribe to lifecycle events fired by Factorial (employee created, employee terminated, attendance clock-in/out, ATS application created/updated, time-off leave created/approved, document created, etc.). Factorial POSTs the event payload to your target URL and retries on failure; consumer endpoints must be idempotent. - aid: factorial:factorial-ats-api name: Factorial ATS API tags: - HR - Recruiting - ATS humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Applicant Tracking surface โ€” Candidates, Applications, Application Phases, Job Postings, Feedback, Evaluation Forms, Answers. Read, create, update, and delete candidates and applications, plus phase progression and structured feedback collection. Part of the dated 2026-04-01 resource API. - aid: factorial:factorial-attendance-api name: Factorial Attendance API tags: - HR - Time - Attendance humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Manage attendance shifts, breaks, overtime requests, timesheet edits, and attendance reviews. v2026-04-01 introduces an api_source field on shift DTOs so integrations can identify themselves on clock operations. - aid: factorial:factorial-time-off-api name: Factorial Time Off API tags: - HR - Time Off - PTO humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Time-off leaves, leave types, and time-off allowances with enriched statistics. Trigger webhooks on leave creation, update, and approval. Combine with the Approvals API to programmatically approve or reject pending leaves. - aid: factorial:factorial-contracts-compensations-api name: Factorial Contracts and Compensations API tags: - HR - Contracts - Compensation humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Manage contract versions and compensation records. v2026-04-01 is a breaking-change release that removes legacy job catalog fields (job_title, professional_category_id, professional_category_description) in favour of job_catalog_tree_node_uuid, and adds richer fields for German and Spanish payroll integrations. - aid: factorial:factorial-payroll-api name: Factorial Payroll API tags: - HR - Payroll - Finance humanURL: https://apidoc.factorialhr.com/docs/payroll-integrations properties: - url: https://apidoc.factorialhr.com/docs/payroll-integrations type: Documentation - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Payroll supplements, payroll identifiers, family situations, and bookkeeper resources. Backs Factorial's integrations with country- specific payroll engines. - aid: factorial:factorial-finance-banking-api name: Factorial Finance and Banking API tags: - Finance - Banking - Accounting humanURL: https://apidoc.factorialhr.com/docs/finance-integrations properties: - url: https://apidoc.factorialhr.com/docs/finance-integrations type: Documentation - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Bank accounts, transactions, ledger accounts, journal entries, tax rates and tax types, cost centers, cost center memberships, and budgets. Cost center memberships are bulk-updatable so percentage splits can be applied atomically per employee. - aid: factorial:factorial-expenses-api name: Factorial Expenses API tags: - Finance - Expenses - Mileage humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: Submit, approve, and reconcile employee expenses, mileage claims, and per-diem requests. - aid: factorial:factorial-documents-api name: Factorial Documents API tags: - HR - Documents - E-Signature humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Manage company- and employee-scoped documents and folders. Create, update, retrieve, and delete documents, request legal e-signatures, and fire document_created webhook events. Admin-only for document creation. - aid: factorial:factorial-performance-api name: Factorial Performance API tags: - HR - Performance - Talent humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Performance reviews, review processes, evaluations, and performance agreements. Configurable review cycles backed by the Job Catalog Tree introduced in v2026-01-01. - aid: factorial:factorial-trainings-api name: Factorial Trainings API tags: - HR - Training - Learning humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Manage training programs and training classes, expanded in v2026-04-01 with new class-level capabilities. - aid: factorial:factorial-job-catalog-api name: Factorial Job Catalog API tags: - HR - Job Catalog - Levels humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Job levels, roles, functions, and the hierarchical Job Catalog Tree introduced in v2026-01-01. Replaces the legacy free-text job_title on contracts via job_catalog_tree_node_uuid. - aid: factorial:factorial-project-management-api name: Factorial Project Management API tags: - Projects - Tasks - Time Tracking humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Projects, subprojects, tasks, project workers, planned and flexible time records, and budget strategies (full CRUD added in v2026-04-01). - aid: factorial:factorial-it-management-api name: Factorial IT Management API tags: - IT - Asset Management - MDM humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- IT asset and IT model endpoints (added in v2026-01-01) backing the SaaS, Inventory, MDM, and Cybersecurity modules. - aid: factorial:factorial-procurement-api name: Factorial Procurement API tags: - Procurement - Purchase Orders humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: Purchase orders, purchase requests, and purchase types. Added in v2026-01-01. - aid: factorial:factorial-approvals-api name: Factorial Approvals API tags: - Workflows - Approvals humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Programmatically approve or reject pending steps of a materialized approval flow, either by id or by resource_id+resource_type. Added in v2026-04-01. - aid: factorial:factorial-locations-holidays-api name: Factorial Locations and Holidays API tags: - HR - Locations - Holidays humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: Company locations, work areas, and company holidays. - aid: factorial:factorial-posts-communities-api name: Factorial Posts and Communities API tags: - Communities - Posts - Communication humanURL: https://apidoc.factorialhr.com/reference properties: - url: https://apidoc.factorialhr.com/reference type: Documentation description: >- Groups, posts, and comments backing the Communities V2 feature. Requires Communities V2 to be enabled on the company. - aid: factorial:factorial-marketplace-integrations-api name: Factorial Marketplace and Integrations API tags: - Integrations - Marketplace humanURL: https://apidoc.factorialhr.com/docs/integrations-framework properties: - url: https://apidoc.factorialhr.com/docs/integrations-framework type: Documentation description: >- Integrations Framework and Marketplace endpoints used by partner integrations to register, surface, and operate within the Factorial app. - aid: factorial:factorial-keys-oauth-api name: Factorial Keys and OAuth API tags: - Authentication - OAuth2 - API Keys humanURL: https://apidoc.factorialhr.com/docs/authentication properties: - url: https://apidoc.factorialhr.com/docs/api-keys type: Documentation - url: https://apidoc.factorialhr.com/docs/oauth-2 type: Documentation - url: https://apidoc.factorialhr.com/docs/oauth-scopes type: Documentation - url: https://apidoc.factorialhr.com/docs/create-a-new-oauth-application type: Documentation - url: https://apidoc.factorialhr.com/docs/oauth2-partner-guide type: Documentation description: >- Two authentication methods. OAuth2 (authorization code flow at /oauth/authorize and /oauth/token) is used to act on behalf of a user; Credentials/API Keys (x-api-key header) are used to act on behalf of the company with full admin access. API Keys overrule OAuth tokens when both are present on the same request. - aid: factorial-hr:factorial-hr-core-employees-v2-api name: Factorial Core::Employees::V2 API description: The Core::Employees::V2 API from Factorial โ€” 2 operation(s) for core::employees::v2. humanURL: https://apidoc.factorialhr.com/reference tags: - Core::Employees::V2 properties: - type: OpenAPI url: openapi/factorial-hr-core-employees-v2-api-openapi.yml - type: Documentation url: https://apidoc.factorialhr.com/ - type: Documentation url: https://apidoc.factorialhr.com/reference - type: JSONSchema url: json-schema/factorial-employee-schema.json - type: JSONLD url: json-ld/factorial-hr-context.jsonld - type: Examples url: examples/factorial-list-employees-example.json - type: Examples url: examples/factorial-create-employee-example.json - type: Examples url: examples/factorial-get-current-user-example.json - aid: factorial-hr:factorial-hr-core-me-api name: Factorial Core::Me API description: The Core::Me API from Factorial โ€” 1 operation(s) for core::me. humanURL: https://apidoc.factorialhr.com/reference tags: - Core::Me properties: - type: OpenAPI url: openapi/factorial-hr-core-me-api-openapi.yml - type: Documentation url: https://apidoc.factorialhr.com/ - type: Documentation url: https://apidoc.factorialhr.com/reference - type: JSONSchema url: json-schema/factorial-employee-schema.json - type: JSONLD url: json-ld/factorial-hr-context.jsonld - type: Examples url: examples/factorial-list-employees-example.json - type: Examples url: examples/factorial-create-employee-example.json - type: Examples url: examples/factorial-get-current-user-example.json name: Factorial tags: - HR - Human Resources - Payroll - Time Off - Time Tracking - ATS - Performance - Finance - Expenses - Spain - Barcelona - All-in-One kind: contract accessModel: pricing: paid onboarding: self-serve trial: false try_now: false public: false label: Paid ยท Self-serve signup confidence: high source: - plans - authentication generated: '2026-07-22' method: derived image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/factorial-hr.png access: 3rd-Party common: - type: AgenticAccess url: agentic-access/factorial-hr-agentic-access.yml - type: TrustCenter url: security/factorial-hr-trust-center.yml - type: VulnerabilityDisclosure url: security/factorial-hr-vulnerability-disclosure.yml - type: DomainSecurity url: security/factorial-hr-domain-security.yml - type: Authentication url: authentication/factorial-hr-authentication.yml - type: OAuthScopes url: scopes/factorial-hr-scopes.yml - type: Portal url: https://factorialhr.com - type: Documentation url: https://apidoc.factorialhr.com/ - type: Documentation name: API Reference url: https://apidoc.factorialhr.com/reference - type: GettingStarted url: https://apidoc.factorialhr.com/docs/getting-started - type: Documentation name: First Steps url: https://apidoc.factorialhr.com/docs/first-steps - type: Documentation name: Authentication url: https://apidoc.factorialhr.com/docs/authentication - type: Documentation name: OAuth 2 url: https://apidoc.factorialhr.com/docs/oauth-2 - type: Documentation name: OAuth Scopes url: https://apidoc.factorialhr.com/docs/oauth-scopes - type: Documentation name: API Keys url: https://apidoc.factorialhr.com/docs/api-keys - type: Documentation name: API Versioning url: https://apidoc.factorialhr.com/docs/api-versioning - type: Documentation name: Production and Demo Environments url: https://apidoc.factorialhr.com/docs/production-and-demo - type: Documentation name: Pagination url: https://apidoc.factorialhr.com/docs/pagination - type: Documentation name: FAQs url: https://apidoc.factorialhr.com/docs/faqs - type: ChangeLog url: https://apidoc.factorialhr.com/changelog - type: Webhooks url: https://apidoc.factorialhr.com/docs/manage-webhooks - type: Documentation name: Webhooks Policies url: https://apidoc.factorialhr.com/docs/webhooks-policies - type: Documentation name: Integrations Framework url: https://apidoc.factorialhr.com/docs/integrations-framework - type: Documentation name: Payroll Integrations url: https://apidoc.factorialhr.com/docs/payroll-integrations - type: Documentation name: Finance Integrations url: https://apidoc.factorialhr.com/docs/finance-integrations - type: Pricing url: https://factorialhr.com/pricing - type: Signup url: https://factorialhr.com/signup - type: Login url: https://app.factorialhr.com/users/sign_in - type: StatusPage url: https://factorial.statuspage.io/ - type: Blog url: https://factorialhr.com/blog - type: Customers url: https://factorialhr.com/customers - type: Support url: https://apidoc.factorialhr.com/docs/contact-page - type: GitHubOrganization url: https://github.com/factorialco - type: SDKs name: OpenAPI Schema Repository url: https://github.com/factorialco/oas - type: SDKs name: Ruby SDK (generated) url: https://github.com/factorialco/oas/tree/main/sdk-ruby - type: SDKs name: Python SDK (generated) url: https://github.com/factorialco/oas/tree/main/sdk-python - type: SDKs name: Java SDK (generated) url: https://github.com/factorialco/oas/tree/main/sdk-java - type: SDKs name: PHP SDK (generated) url: https://github.com/factorialco/oas/tree/main/sdk-php - type: SDKs name: TypeScript Axios SDK (generated) url: https://github.com/factorialco/oas/tree/main/sdk-typescript-axios - type: SDKs name: Node.js Server SDK (generated) url: https://github.com/factorialco/oas/tree/main/sdk-nodejs-server - type: Tools name: f0 Design System url: https://github.com/factorialco/f0 - type: PrivacyPolicy url: https://factorialhr.com/privacy-policy - type: TermsOfService url: https://factorialhr.com/terms-and-conditions - type: LinkedIn url: https://www.linkedin.com/company/factorial-hr/ - type: Plans url: plans/factorial-plans-pricing.yml - type: RateLimits url: rate-limits/factorial-rate-limits.yml - type: FinOps url: finops/factorial-finops.yml - type: SpectralRules url: rules/factorial-rules.yml - type: Vocabulary url: vocabulary/factorial-hr-vocabulary.yml - type: Features data: - All-in-one HR, payroll, time, finance, talent, and IT modules - Public REST API with dated, major-versioned releases (current 2026-04-01 "Legendre") - Two auth schemes - OAuth2 authorization code on behalf of a user and x-api-key on behalf of the company - 30+ OAuth scopes for fine-grained partner access - Production and Demo environments (api.factorialhr.com vs api.demo.factorialhr.com) - 681+ documented endpoints across 30+ resource domains - Webhook subscriptions with documented event catalogue and retry policy - Approvals API for programmatic approve/reject of pending workflows - Job Catalog Tree replacing free-text job titles on contracts - Bulk endpoints (e.g. cost-center memberships) to reduce roundtrips - Integrations Framework, Payroll and Finance Integrations partner programs - Marketplace surface for distributing partner integrations inside the Factorial app - Officially generated SDKs for Ruby, Python, Java, PHP, TypeScript (axios), and Node.js server - llms.txt endpoint for AI agents at https://apidoc.factorialhr.com/llms.txt - 16,000+ companies on platform; HQ in Barcelona, Spain sources: - https://factorialhr.com - https://apidoc.factorialhr.com/ - https://apidoc.factorialhr.com/changelog - https://github.com/factorialco/oas updated: '2026-05-25' created: '2026-05-25' modified: '2026-05-25' position: Consuming description: >- Factorial is an all-in-one HR, payroll, time, talent, finance, and IT management platform headquartered in Barcelona, Spain, used by 16,000+ companies worldwide. The Factorial public API is a date-versioned REST API (current major 2026-04-01 "Legendre") covering employees, contracts, attendance, time off, payroll, ATS, performance, trainings, projects, finance, banking, procurement, IT assets, documents, webhooks, and an Approvals workflow surface. Authentication uses OAuth2 (on behalf of a user) or an x-api-key header (on behalf of the company), with 30+ scopes for granular partner access. Factorial publishes the OpenAPI schema and generated SDKs (Ruby, Python, Java, PHP, TypeScript, Node.js) at github.com/factorialco/oas and exposes an llms.txt index for AI agents. maintainers: - FN: Kin Lane email: info@apievangelist.com X: apievangelist url: https://apievangelist.com specificationVersion: '0.16'