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.
Factorial publishes 24 API contracts indexed on the APIs.io network, including Core::Employees::V2 API, Core::Me API, Resources API, and 21 more. Tagged areas include Human Resources, Payroll, Time Off, Time Tracking, and Applicant Tracking.
The Factorial catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Factorial’s developer surface includes authentication, developer portal, documentation, getting-started guide, changelog, pricing, signup flow, and 44 more developer resources.
53.3/100developing▬ flatAgent49/100agent readyFront door AI4/6
moderate
Heartbeat100/100
alive
saas
Full breakdown ↓
scored 2026-11-13 · rubric v0.28.0 · Show this score on your site →
Regulatory Posture applies to this provider. Its tags matched the
Employment & Payroll regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/factorial-hr/"><img src="https://apis.io/badge/factorial-hr/card.svg" alt="Factorial on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented) Ask about this →
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes Ask about this →
Pagination+5 pts — share of collection GETs (an array, or one wrapped in data/items/results ...) that declare a page/limit/offset/cursor parameter, a Link header or a next/cursor field; na with no collection GETs Ask about this →
Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.
Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
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 identi...
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 progr...
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, professi...
Payroll supplements, payroll identifiers, family situations, and bookkeeper resources. Backs Factorial's integrations with country- specific payroll engines.
Bank accounts, transactions, ledger accounts, journal entries, tax rates and tax types, cost centers, cost center memberships, and budgets. Cost center memberships are bulk-upda...
Manage company- and employee-scoped documents and folders. Create, update, retrieve, and delete documents, request legal e-signatures, and fire document_created webhook events. ...
Performance reviews, review processes, evaluations, and performance agreements. Configurable review cycles backed by the Job Catalog Tree introduced in v2026-01-01.
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.
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...
Versioned REST API for managing employees, contracts, leaves, attendance shifts, time off, documents, and other HR resources in Factorial. Supports API key (Bearer token) and OA...
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:
- Human Resources
- Webhook
- Event
tags_raw:
- 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:
- Human Resources
- Recruiting
- Applicant Tracking
tags_raw:
- 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:
- Human Resources
- Time
- Attendance
tags_raw:
- 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:
- Human Resources
- Time Off
- PTO
tags_raw:
- 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:
- Human Resources
- Contracts
- Compensation
tags_raw:
- 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:
- Human Resources
- Payroll
- Finance
tags_raw:
- 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:
- Human Resources
- Documents
- E-Signature
tags_raw:
- 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:
- Human Resources
- Performance
- Talent
tags_raw:
- 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:
- Human Resources
- Training
- Learning
tags_raw:
- 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:
- Human Resources
- Job Catalog
- Levels
tags_raw:
- 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:
- Project
- Task
- Time Tracking
tags_raw:
- 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:
- Human Resources
- Location
- Holidays
tags_raw:
- 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:
- Community
- Posts
- Communications
tags_raw:
- 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:
- Integration
- Marketplace
tags_raw:
- 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
- OAuth
- APIKeys
tags_raw:
- 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
- aid: factorial-hr:developer-api
name: Factorial Developer API
description: Versioned REST API for managing employees, contracts, leaves, attendance shifts, time off, documents, and other
HR resources in Factorial. Supports API key (Bearer token) and OAuth 2.0 authentication, with separate production and
demo environments.
humanURL: https://apidoc.factorialhr.com
baseURL: https://api.factorialhr.com
tags:
- Human Resources
- HRIS
- Employees
- Attendance
- Time Off
- Payroll
properties:
- type: Documentation
url: https://apidoc.factorialhr.com
- type: GettingStarted
url: https://apidoc.factorialhr.com/docs/getting-started
- type: Authentication
url: https://apidoc.factorialhr.com/docs/authentication
- type: Environments
url: https://apidoc.factorialhr.com/docs/production-and-demo
- aid: factorial-hr:factorial-hr-resources-api
name: Factorial Resources API
description: The Resources API from Factorial — 16 operation(s) for resources.
humanURL: https://apidoc.factorialhr.com/docs/manage-webhooks
baseURL: https://api.factorialhr.com
tags:
- Resources
properties:
- type: OpenAPI
url: openapi/factorial-hr-resources-api-openapi.yml
name: Factorial
tags:
- Human Resources
- Payroll
- Time Off
- Time Tracking
- Applicant Tracking
- Performance
- Finance
- Expenses
- Spain
- Barcelona
- All-in-One
tags_raw:
- HR
- Human Resources
- Payroll
- Time Off
- Time Tracking
- ATS
- Performance
- Finance
- Expenses
- Spain
- Barcelona
- All-in-One
kind: contract
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: paid
onboarding: unknown
trial: false
try_now: false
public: false
label: Paid
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-13'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/factorial-hr.png
access: 3rd-Party
common:
- type: CapabilityMap
url: capabilities/factorial-hr-capability-edges.yml
name: Factorial Business Capability Map
- type: Website
url: https://www.factorialhr.com/
- 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.23'
Factorial API — frequently asked questions
Does Factorial have an API?
Yes. APIs.io lists 24 APIs from Factorial, including Factorial Webhooks API, Factorial ATS API and Factorial Attendance API, and 21 more.
Is there an OpenAPI specification for the Factorial API?
Yes. APIs.io indexes 3 OpenAPI specifications for Factorial, each linked for download from this page.
How do I authenticate with the Factorial API?
Factorial documents its authentication (apiKey/oauth2 · 2 schemes). The details are profiled on APIs.io as Factorial Authentication.
How much does the Factorial API cost?
Factorial publishes its prices; its Tailored plan (starts at) plan is $8 per month, per user as of 2026-10-28. APIs.io lists 2 pricing plans for Factorial, with each plan's price, limits and inclusions under Pricing on this page.
Does Factorial have an MCP server?
Yes. APIs.io lists 1 MCP server for Factorial: Remote MCP server at mcp.factorialhr.com over HTTP.
Is the Factorial API ready for AI agents?
Factorial has a Kin Score of 53.3 out of 100 (developing) and an Agent Readiness score of 48.5 (agent-ready), scored by API Evangelist on 2026-11-13.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.