# Factorial **Canonical:** https://apis.io/providers/factorial-hr/ **Website:** https://factorialhr.com **APIs profiled:** 1 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. ## Kin Score — 52.9 / 100 (developing) Scored 2026-08-30 under rubric 0.17.2. Trend: flat (-0.6 from 53.5). | Facet | Score | |---|---| | Discoverability | 59.3 | | Contract Quality | 63.9 | | Governance | 28.8 | | Contract Governance | 28.8 | | Operational Transparency | 30.3 | | Developer Ergonomics | 53.6 | | Commercial Clarity | 64.5 | | Access Clarity | 64.5 | ## Agent readiness — 34.2 (agent-ready) | Dimension | Value | |---|---| | Spec Presence | yes | | Agentic Access | derived | | Reversibility Documented | no | | MCP Server | no | | Auth Clarity | negotiable | | Idempotency | no | | Error Semantics | no | | OpenAPI Examples | verified | | Rate Limit Signal | documented | | Event Surface Described | yes | | Agent Skills | no | | Well Known Catalog | no | | Consent Identity | no | | Agent Card | no | | Dry Run Mode | no | | Delegated Identity | documented | | Protected Resource Metadata | no | | Dynamic Client Registration | no | | Agentic Commerce | no | ## Access Paid · Self-serve signup — onboarding: self-serve, pricing: paid, trial: no (confidence: high). ## APIs (22) - **Factorial Webhooks API** — Subscribe to lifecycle events fired by Factorial (employee created, employee terminated, attendance clock-in/out, ATS application created/updated, time-off leave created/approve... - **Factorial ATS API** — Applicant Tracking surface — Candidates, Applications, Application Phases, Job Postings, Feedback, Evaluation Forms, Answers. Read, create, update, and delete candidates and app... - **Factorial Attendance API** — 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... - **Factorial Time Off API** — 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... - **Factorial Contracts and Compensations API** — 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... - **Factorial Payroll API** — Payroll supplements, payroll identifiers, family situations, and bookkeeper resources. Backs Factorial's integrations with country- specific payroll engines. - **Factorial Finance and Banking API** — 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... - **Factorial Expenses API** — Submit, approve, and reconcile employee expenses, mileage claims, and per-diem requests. - **Factorial Documents API** — Manage company- and employee-scoped documents and folders. Create, update, retrieve, and delete documents, request legal e-signatures, and fire document_created webhook events. ... - **Factorial Performance API** — Performance reviews, review processes, evaluations, and performance agreements. Configurable review cycles backed by the Job Catalog Tree introduced in v2026-01-01. - **Factorial Trainings API** — Manage training programs and training classes, expanded in v2026-04-01 with new class-level capabilities. - **Factorial Job Catalog API** — 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. - **Factorial Project Management API** — Projects, subprojects, tasks, project workers, planned and flexible time records, and budget strategies (full CRUD added in v2026-04-01). - **Factorial IT Management API** — IT asset and IT model endpoints (added in v2026-01-01) backing the SaaS, Inventory, MDM, and Cybersecurity modules. - **Factorial Procurement API** — Purchase orders, purchase requests, and purchase types. Added in v2026-01-01. - **Factorial Approvals API** — 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. - **Factorial Locations and Holidays API** — Company locations, work areas, and company holidays. - **Factorial Posts and Communities API** — Groups, posts, and comments backing the Communities V2 feature. Requires Communities V2 to be enabled on the company. - **Factorial Marketplace and Integrations API** — Integrations Framework and Marketplace endpoints used by partner integrations to register, surface, and operate within the Factorial app. - **Factorial Keys and OAuth API** — 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... - **Factorial Core::Employees::V2 API** — The Core::Employees::V2 API from Factorial — 2 operation(s) for core::employees::v2. - **Factorial Core::Me API** — The Core::Me API from Factorial — 1 operation(s) for core::me. ## Agentic access (1) - **Factorial Hr Agentic Access** — 5 operations · 2 acting ## Security (4) - **Factorial Hr Authentication** — apiKey/oauth2 · 2 schemes - **Factorial Hr Domain Security** — TLSv1.3 · HSTS · DMARC - **Factorial Hr Vulnerability Disclosure** — Hackerone · security.txt · contact published - **Factorial Hr Trust Center** — SOC 2, ISO 27001 ## Plans (1) - **Factorial Plans Pricing** ## Tags HR, Human Resources, Payroll, Time Off, Time Tracking, ATS, Performance, Finance, Expenses, Spain, Barcelona, All-in-One --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/factorial-hr/). Scores are computed from the provider's own public artifacts under a published rubric.