Factorial · Schema

Factorial Employee

An employee record in Factorial HR. Mirrors the Employee schema exposed by the public Core Employees v2 API.

HRHuman ResourcesPayrollTime OffTime TrackingATSPerformanceFinanceExpensesSpainBarcelonaAll-in-One

Properties

Name Type Description
id integer Unique identifier of the employee.
email string
first_name string
last_name string
birthday_on string
role string
terminated_on string
gender string
nationality string ISO 3166-1 alpha-2 country code of nationality.
bank_number string
swift_bic string
country string ISO 3166-1 alpha-2 country code.
city string
state string
postal_code string
address_line_1 string
address_line_2 string
identifier string National identifier (e.g. Spanish DNI/NIE).
company_id integer
legal_entity_id integer
manager_id integer
timeoff_manager_id integer
View JSON Schema on GitHub

JSON Schema

factorial-employee-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/factorial-hr/main/json-schema/factorial-employee-schema.json",
  "title": "Factorial Employee",
  "description": "An employee record in Factorial HR. Mirrors the Employee schema exposed by the public Core Employees v2 API.",
  "type": "object",
  "properties": {
    "id": { "type": "integer", "description": "Unique identifier of the employee." },
    "email": { "type": "string", "format": "email" },
    "first_name": { "type": "string" },
    "last_name": { "type": "string" },
    "birthday_on": { "type": "string", "format": "date" },
    "role": { "type": "string", "enum": ["basic", "admin"] },
    "terminated_on": { "type": "string", "format": "date" },
    "gender": { "type": "string", "enum": ["male", "female"] },
    "nationality": { "type": "string", "description": "ISO 3166-1 alpha-2 country code of nationality." },
    "bank_number": { "type": "string" },
    "swift_bic": { "type": "string" },
    "country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code." },
    "city": { "type": "string" },
    "state": { "type": "string" },
    "postal_code": { "type": "string" },
    "address_line_1": { "type": "string" },
    "address_line_2": { "type": "string" },
    "identifier": { "type": "string", "description": "National identifier (e.g. Spanish DNI/NIE)." },
    "company_id": { "type": "integer" },
    "legal_entity_id": { "type": "integer" },
    "manager_id": { "type": "integer" },
    "timeoff_manager_id": { "type": "integer" }
  },
  "required": ["email", "first_name", "last_name", "company_id"]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/factorial-employee"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.