This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.
Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema,
apis.json,llms.txtand similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.
Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.
- Something wrong? Open an issue on this repository, or email info@apievangelist.com.
- Published something new? Ask for a re-score and we will re-run the rating.
- Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.
Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.
Not from the company, and here with a question? You are welcome here — we would rather be the front line and point you the right way than have a good report go nowhere. What this repository can answer is narrow, though, so it is worth knowing who you are actually looking for:
- A question about how the API works, an account, billing, or a bug in the service — that is the company's own support, not us. We profile this API; we do not operate it and cannot see your account.
- A bug in an open-source project we only catalog — file it on that project's own repository. This has happened with a real and correct bug report that reached us instead of the people who could fix it, which helped nobody.
- Anything about this listing itself — the description, the tags, the rating, a missing or wrong artifact — is ours. Open an issue here.
- Not sure, or something general about API Evangelist or APIs.io — open an issue on the APIs.io Inbox and we will route it.
This repository contains no software, and we will never ask you to download anything. There is no build, release, installer, or binary here — only text and machine-readable API descriptions, so there is nothing here that can be "corrupt" or need "repairing". Any issue, comment, or email claiming otherwise and offering a download link is not from us and is hostile. Do not follow the link; it is a lure. Report it to GitHub and, if you like, tell us at info@apievangelist.com so we can take it down.
On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.
Full detail: Where this data comes from
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.
APIs.json: https://raw.githubusercontent.com/api-evangelist/factorial-hr/refs/heads/main/apis.yml
- Position: Consuming
- Access: 3rd-Party
- HR
- Human Resources
- Payroll
- Time Off
- Time Tracking
- ATS
- Performance
- Finance
- Expenses
- Spain
- Barcelona
- All-in-One
- Created: 2026-05-25
- Modified: 2026-05-25
List, read, create, and update employees in the Factorial HR directory. The Core Employees v2 API exposes a clean, non-data-intensive employee record (replacing the legacy v1 shape) plus the /v1/me endpoint for identifying the current OAuth2 token holder. Supports both OAuth2 and x-api-key authentication.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Employees
- Core
- Documentation
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
- JSON Schema — JSON Schema
- JSON-LD — JSON-LD
- Example
- Example
- Example
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.
- HR
- Webhooks
- Events
- Documentation
- Documentation
- Documentation
- Documentation
- JSON Schema — JSON Schema
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
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.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Recruiting
- ATS
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.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Time
- Attendance
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.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Time Off
- PTO
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.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Contracts
- Compensation
Payroll supplements, payroll identifiers, family situations, and bookkeeper resources. Backs Factorial's integrations with country- specific payroll engines.
- HR
- Payroll
- Finance
- Documentation
- Documentation
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
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.
- Finance
- Banking
- Accounting
- Documentation
- Documentation
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Submit, approve, and reconcile employee expenses, mileage claims, and per-diem requests.
- Human URL: https://apidoc.factorialhr.com/reference
- Finance
- Expenses
- Mileage
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.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Documents
- E-Signature
Performance reviews, review processes, evaluations, and performance agreements. Configurable review cycles backed by the Job Catalog Tree introduced in v2026-01-01.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Performance
- Talent
Manage training programs and training classes, expanded in v2026-04-01 with new class-level capabilities.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Training
- Learning
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.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Job Catalog
- Levels
Projects, subprojects, tasks, project workers, planned and flexible time records, and budget strategies (full CRUD added in v2026-04-01).
- Human URL: https://apidoc.factorialhr.com/reference
- Projects
- Tasks
- Time Tracking
IT asset and IT model endpoints (added in v2026-01-01) backing the SaaS, Inventory, MDM, and Cybersecurity modules.
- Human URL: https://apidoc.factorialhr.com/reference
- IT
- Asset Management
- MDM
Purchase orders, purchase requests, and purchase types. Added in v2026-01-01.
- Human URL: https://apidoc.factorialhr.com/reference
- Procurement
- Purchase Orders
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.
- Human URL: https://apidoc.factorialhr.com/reference
- Workflows
- Approvals
Company locations, work areas, and company holidays.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Locations
- Holidays
Define custom fields, options, values, and schemas to extend Factorial resources with company-specific metadata.
- Human URL: https://apidoc.factorialhr.com/reference
- HR
- Custom Fields
- Extensibility
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Groups, posts, and comments backing the Communities V2 feature. Requires Communities V2 to be enabled on the company.
- Human URL: https://apidoc.factorialhr.com/reference
- Communities
- Posts
- Communication
Integrations Framework and Marketplace endpoints used by partner integrations to register, surface, and operate within the Factorial app.
- Integrations
- Marketplace
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.
- Authentication
- OAuth2
- API Keys
- Documentation
- Documentation
- Documentation
- Documentation
- Documentation
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
- Portal
- Documentation
- Documentation
- Getting Started
- Documentation
- Documentation
- Documentation
- Documentation
- Documentation
- Documentation
- Documentation
- Documentation
- Documentation
- Changelog
- Webhooks
- Documentation
- Documentation
- Documentation
- Documentation
- Pricing
- Sign Up
- Login
- Status Page
- Blog
- Customers
- Support
- GitHub Organization
- SDK
- SDK
- SDK
- SDK
- SDK
- SDK
- SDK
- Tool
- Privacy Policy
- Terms of Service
- Plans
- Rate Limits
- Fin Ops
- Spectral Rules
- Vocabulary
- Features
FN: Kin Lane Email: info@apievangelist.com URL: https://apievangelist.com