Factorial website screenshot

Factorial

Factorial is a Spain-headquartered HRIS and human resources platform offering employee management, time tracking, attendance, time off, payroll, performance, recruitment, documents, and expenses for small and mid-sized businesses. The Factorial Developer API provides versioned REST endpoints (dated like 2026-04-01) for integrating with employees, leaves, contracts, attendance shifts, and other HR resources, with API key and OAuth 2.0 authentication and both production and demo environments.

Factorial publishes 1 API on the APIs.io network: Resources API. Tagged areas include Human Resources, HRIS, Employee Management, Time Tracking, and Payroll.

Factorial’s developer surface includes authentication, documentation, pricing, signup flow, support, engineering blog, and 21 more developer resources.

🌐 Visit website 📡 Source on GitHub
29.8/100 thin ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
2 APIs
Human ResourcesHRISEmployee ManagementTime TrackingPayrollTime OffPerformance Management

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 29.8/100 · thin
Contract Quality 13.4 / 25
Developer Ergonomics 5.2 / 20
Commercial Clarity 3.7 / 20
Operational Transparency 0.7 / 13
Governance 0.0 / 12
Discoverability 6.9 / 10
Agent readiness — 28/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/factorial: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 2

Individual APIs this provider publishes, each with its own machine-readable definition.

Factorial Developer API

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...

Factorial Resources API

The Resources API from Factorial — 16 operation(s) for resources.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Factorial Developer API

OPEN COLLECTION

Arazzo Workflows 12

Multi-step API workflows described with the Arazzo specification.

Factorial Add Payroll Supplement

Confirm an employee, add a payroll supplement for them, and list supplements to confirm.

ARAZZO

Factorial Amend Contract

Find an existing contract version and update it, otherwise create a new one.

ARAZZO

Factorial Attendance Day

Clock an employee in, confirm the open shift, then clock them out.

ARAZZO

Factorial Create Contract Version

Confirm an employee exists, create a contract version for them, and read it back.

ARAZZO

Factorial Find Employee and File Leave

Look up an employee by email, then file a time off request for the matched employee.

ARAZZO

Factorial Log Attendance Shift

Confirm an employee, log a completed attendance shift, and read it back.

ARAZZO

Factorial Offboard Employee

Confirm an employee, terminate them, and verify the termination was recorded.

ARAZZO

Factorial Onboard Employee

Create an employee, confirm the record, assign teams, and send the Factorial invitation.

ARAZZO

Factorial Reschedule Time Off

Find an employee's existing leave, reschedule it, and confirm the new dates.

ARAZZO

Factorial Submit Time Off

Create a time off request and read back its stored status.

ARAZZO

Factorial Update Employee Profile

Confirm an employee, update their profile fields, and read the record back.

ARAZZO

Factorial Upload Employee Document

Confirm an employee, upload a document for them, and confirm it appears in their documents.

ARAZZO

Scroll for all 12

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Factorial Authentication

http/oauth2 · 2 schemes

SECURITY

Factorial Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Factorial Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Factorial Trust Center

SOC 2, ISO 27001

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Factorial Scopes

2 scopes · authorizationCode

2 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Factorial Agentic Access

30 operations · 18 acting · 1 human-in-the-loop

30 operations · 18 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Signup
Signup

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 LlmsText
LlmsText

Design & Contract 12

Pagination, idempotency, versioning, errors, and events

Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo

Scroll for all 12

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 1

Pricing, plans, and the legal terms of use

Pricing
Pricing

Company 3

The organization behind the API

Website
Website
 LinkedIn
LinkedIn
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: factorial
name: Factorial
description: Factorial is a Spain-headquartered HRIS and human resources platform offering employee management, time tracking,
  attendance, time off, payroll, performance, recruitment, documents, and expenses for small and mid-sized businesses. The
  Factorial Developer API provides versioned REST endpoints (dated like 2026-04-01) for integrating with employees, leaves,
  contracts, attendance shifts, and other HR resources, with API key and OAuth 2.0 authentication and both production and
  demo environments.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/factorial.png
tags:
- Human Resources
- HRIS
- Employee Management
- Time Tracking
- Payroll
- Time Off
- Performance Management
url: https://raw.githubusercontent.com/api-evangelist/factorial/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-05-11'
specificationVersion: '0.19'
apis:
- aid: factorial: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:factorial-resources-api
  name: Factorial Resources API
  description: The Resources API from Factorial — 16 operation(s) for resources.
  humanURL: https://apidoc.factorialhr.com
  baseURL: https://api.factorialhr.com
  tags:
  - Resources
  properties:
  - type: OpenAPI
    url: openapi/factorial-resources-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/factorial-agentic-access.yml
- type: TrustCenter
  url: security/factorial-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/factorial-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/factorial-domain-security.yml
- type: Authentication
  url: authentication/factorial-authentication.yml
- type: OAuthScopes
  url: scopes/factorial-scopes.yml
- type: Arazzo
  url: arazzo/factorial-add-payroll-supplement-workflow.yml
  name: Factorial Add Payroll Supplement
- type: Arazzo
  url: arazzo/factorial-amend-contract-workflow.yml
  name: Factorial Amend Contract
- type: Arazzo
  url: arazzo/factorial-attendance-day-workflow.yml
  name: Factorial Attendance Day
- type: Arazzo
  url: arazzo/factorial-create-contract-workflow.yml
  name: Factorial Create Contract Version
- type: Arazzo
  url: arazzo/factorial-find-employee-file-leave-workflow.yml
  name: Factorial Find Employee and File Leave
- type: Arazzo
  url: arazzo/factorial-log-attendance-shift-workflow.yml
  name: Factorial Log Attendance Shift
- type: Arazzo
  url: arazzo/factorial-offboard-employee-workflow.yml
  name: Factorial Offboard Employee
- type: Arazzo
  url: arazzo/factorial-onboard-employee-workflow.yml
  name: Factorial Onboard Employee
- type: Arazzo
  url: arazzo/factorial-reschedule-time-off-workflow.yml
  name: Factorial Reschedule Time Off
- type: Arazzo
  url: arazzo/factorial-submit-time-off-workflow.yml
  name: Factorial Submit Time Off
- type: Arazzo
  url: arazzo/factorial-update-employee-profile-workflow.yml
  name: Factorial Update Employee Profile
- type: Arazzo
  url: arazzo/factorial-upload-employee-document-workflow.yml
  name: Factorial Upload Employee Document
- type: GitHubOrganization
  url: https://github.com/factorialco
- type: Website
  url: https://factorialhr.com
- type: Documentation
  url: https://apidoc.factorialhr.com
- type: Pricing
  url: https://factorialhr.com/pricing
- type: Signup
  url: https://factorialhr.com/signup
- type: Support
  url: https://help.factorialhr.com
- type: LinkedIn
  url: https://www.linkedin.com/company/factorial-hr
- type: LlmsText
  url: https://factorialhr.com/llms.txt
- url: https://factorialhr.com/blog/feed
  type: Blog
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com