Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Humaans website screenshot

Humaans

Humaans is a London-headquartered modern HRIS (Human Resources Information System) for fast-growing, distributed teams. The platform combines a best-in-class system of record — employee directory, documents, time off, timesheets, compensation, equipment, locations, custom fields and tables, performance reviews, and onboarding/offboarding workflows — with the Athena agentic AI platform and an AI Companion that automate administrative HR work. Humaans exposes a comprehensive REST API at app.humaans.io/api with Bearer token authentication, OAuth-style scopes, $limit/$skip pagination, rich filter operators, and HMAC SHA-256 signed webhooks. The API spans 70+ documented resource categories including People, Companies, Compensations, Bank Accounts, Documents, Time Away (entries, allocations, policies, types), Equipment, Job Roles, Locations, Custom Fields and Values, Performance, Timesheet entries and submissions, Webhooks, Audit Events, and Working Patterns. Humaans ships pre-built integrations across payroll, identity, compliance, finance, ATS, performance, benefits, learning, and automation, plus a Zapier connector and an Apideck HRIS unified-API binding. Trusted by global teams across 300+ locations and rated 4.8/5 on G2.

agent aware

Real signal across most facets with visible, nameable gaps — the contract exists but is thin, or the portal is good while governance and commercial terms are absent.

Kin Score

API Evangelist profiles Humaans the way a machine reads it — 41 machine-readable artifacts across 15 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.

Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Humaans scores 47.6/100 (developing), with a separate agent-readiness read of 41/100 (agent aware). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.

Kin Score

This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 47.6/100 · developing
Contract Quality 12.8 / 25
Developer Ergonomics 12.2 / 20
Commercial Clarity 10.5 / 20
Operational Transparency 2.1 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 41/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
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

How we profile Humaans

Each block below is one kind of artifact we hold for Humaans. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.

APIs 15

Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.

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

Humaans Audit Events API

Read-only audit trail

Humaans Bank Accounts API

Employee bank account records

Humaans Companies API

Tenant company record

Humaans Compensations API

Salary, bonus, and compensation history

Humaans Custom Fields API

Tenant-defined custom field definitions and values

Humaans Documents API

Personal and company document storage

Humaans Equipment API

Equipment assigned to employees

Humaans Job Roles API

Position and role definitions

Humaans Locations API

Office and remote work locations

Humaans People API

Employee records, the canonical resource of the HRIS

Humaans Performance API

Performance reviews, cycles, templates, and ratings

Humaans Time Away API

Time off, holidays, leave allocations, policies, and types

Humaans Timesheet API

Timesheet entries and submissions

Humaans Webhooks API

Outbound HMAC-signed event subscriptions

Humaans Working Patterns API

Work schedule patterns

Scroll within the panel for all 15 ·

Open Collections 1

Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.

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

Humaans API

OPEN COLLECTION

Features 20

The notable capabilities this provider advertises, captured as structured features so they can be searched and compared instead of read one landing page at a time.

Notable capabilities this provider offers.

REST HRIS API with consistent resource-oriented URLs, JSON in / JSON out, and standard HTTP verbs and status codes
Bearer token authentication with OAuth-style scopes (public:read, private:read, private:write, compensations:read/write, documents:read/write, webhooks:manage)
Role-based access control (Owner, Admin, Finance, Tech, Manager, User) reflected in API access
Pagination via $limit (default 100, max 250) and $skip
Rich filtering operators ($in, $nin, $gt, $gte, $lt, $lte, $or) on most collections
70+ documented resource categories — People, Companies, Compensations, Bank Accounts, Documents, Document Folders, Document Types, Identity Documents
Time Away — entries, allocations, types, policies, and accruals
Equipment, Job Roles, Locations, Custom Fields, Custom Values, Working Patterns
Performance — reviews, cycles, templates, ratings (mostly read)
Timesheet entries and submissions with full CRUD
HMAC SHA-256 signed webhooks with exponential backoff retry and auto-disable after 5 days of failures
Read-only Audit Events stream for compliance and SIEM integration
Pre-built integrations across Payroll (Remote, Oyster, Papaya Global, Symmetrical, Payap, PayCaptain, Salary), Identity (Okta, JumpCloud, Microsoft Entra ID, Google SSO, SAML), Compliance (Vanta, Drata, Secureframe), Finance (Carta, Pulley, Pleo, Spendesk, Moss, Ramp, Pave, Ravio, Figures, Ledgy, Mesh Payments, Cledara), ATS (Greenhouse, Lever, Workable, Ashby, Teamtailor, Gem, Pinpoint, Manatal), Performance (Lattice, CultureAmp, Leapsome, Workvivo, Eletive, Officevibe, Frankli, Appraisd), Calendar/Comms (Google Calendar, Slack), eSignature (Docusign, Contractbook), Benefits (Ben, Assembly, Bonusly, Goody, Kota, Happl, CakeDrop), Learning (Sana Labs, WorkRamp, Ethena), Automation (Zapier), People Analytics (ChartHop, Insightful)
Native Apideck HRIS unified-API connector for Humaans
Athena agentic AI platform plus AI Companion add-on for natural-language HR queries
Workflow automation, onboarding/offboarding sequences, and dynamic databases (custom data tables)
300+ global locations supported with country-specific localisation
iOS and Android mobile apps
SOC 2, ISO 27001, and GDPR-aligned controls; Vanta/Drata/Secureframe automation integrations
99.9% uptime SLA on the Enterprise plan

Scroll within the panel for all 20 ·

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.

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

Humaans Io Authentication

http · 1 scheme

SECURITY

Humaans Io Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Humaans Io Vulnerability Disclosure

disclosure policy published

SECURITY

Humaans Io Trust Center

SOC 2, ISO 27001, GDPR

SECURITY

Agentic Access 1

An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.

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

Humaans Io Agentic Access

63 operations · 31 acting

63 operations · 31 acting

AGENTIC

Resources

Every other property we hold for Humaans — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.

Get Started 4

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

← All providers · Data indexed from github.com/api-evangelist/humaans-io · machine-readable index on apis.io