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.
Humaans publishes 15 API contracts indexed on the APIs.io network, including Audit Events API, Bank Accounts API, Companies API, and 12 more. Tagged areas include Human Resources, HRIS, People Operations, People Analytics, and Onboarding.
The Humaans catalog on APIs.io includes 1 Spectral governance ruleset.
Humaans’ developer surface includes authentication, developer portal, documentation, getting-started guide, signup flow, pricing, engineering blog, and 30 more developer resources.
53.9/100developing▬ flatAgent45/100agent readyFront door AI5/6
prominent
Heartbeat100/100
alive
saas
Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →
Regulatory Posture applies to this provider. Its tags matched the
Employment & Payroll regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/humaans-io/"><img src="https://apis.io/badge/humaans-io/card.svg" alt="Humaans on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Rate-Limit Signaling+7 pts — OpenAPI responses document X-RateLimit-* / RateLimit headers (verified), else a rate_limits artifact or RateLimits link (documented)
Request/Response Examples+7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Typed Event Surface+6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks
6 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
aid: humaans-io
url: https://raw.githubusercontent.com/api-evangelist/humaans-io/refs/heads/main/apis.yml
apis:
- aid: humaans-io:humaans-io-audit-events-api
name: Humaans Audit Events API
description: Read-only audit trail
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Audit Events
properties:
- type: OpenAPI
url: openapi/humaans-io-audit-events-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-bank-accounts-api
name: Humaans Bank Accounts API
description: Employee bank account records
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Bank Accounts
properties:
- type: OpenAPI
url: openapi/humaans-io-bank-accounts-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-companies-api
name: Humaans Companies API
description: Tenant company record
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Companies
properties:
- type: OpenAPI
url: openapi/humaans-io-companies-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-compensations-api
name: Humaans Compensations API
description: Salary, bonus, and compensation history
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Compensations
properties:
- type: OpenAPI
url: openapi/humaans-io-compensations-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-custom-fields-api
name: Humaans Custom Fields API
description: Tenant-defined custom field definitions and values
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Custom Fields
properties:
- type: OpenAPI
url: openapi/humaans-io-custom-fields-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-documents-api
name: Humaans Documents API
description: Personal and company document storage
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Documents
properties:
- type: OpenAPI
url: openapi/humaans-io-documents-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-equipment-api
name: Humaans Equipment API
description: Equipment assigned to employees
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Equipment
properties:
- type: OpenAPI
url: openapi/humaans-io-equipment-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-job-roles-api
name: Humaans Job Roles API
description: Position and role definitions
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Job Roles
properties:
- type: OpenAPI
url: openapi/humaans-io-job-roles-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-locations-api
name: Humaans Locations API
description: Office and remote work locations
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Location
tags_raw:
- Locations
properties:
- type: OpenAPI
url: openapi/humaans-io-locations-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-people-api
name: Humaans People API
description: Employee records, the canonical resource of the HRIS
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- People
properties:
- type: OpenAPI
url: openapi/humaans-io-people-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-performance-api
name: Humaans Performance API
description: Performance reviews, cycles, templates, and ratings
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Performance
properties:
- type: OpenAPI
url: openapi/humaans-io-performance-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-time-away-api
name: Humaans Time Away API
description: Time off, holidays, leave allocations, policies, and types
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Time Away
properties:
- type: OpenAPI
url: openapi/humaans-io-time-away-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-timesheet-api
name: Humaans Timesheet API
description: Timesheet entries and submissions
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Timesheet
properties:
- type: OpenAPI
url: openapi/humaans-io-timesheet-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-webhooks-api
name: Humaans Webhooks API
description: Outbound HMAC-signed event subscriptions
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Webhook
tags_raw:
- Webhooks
properties:
- type: OpenAPI
url: openapi/humaans-io-webhooks-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
- aid: humaans-io:humaans-io-working-patterns-api
name: Humaans Working Patterns API
description: Work schedule patterns
humanURL: https://docs.humaans.io/api/
baseURL: https://app.humaans.io/api
tags:
- Working Patterns
properties:
- type: OpenAPI
url: openapi/humaans-io-working-patterns-api-openapi.yml
- type: Documentation
url: https://docs.humaans.io/api/
- type: Documentation
url: https://docs.humaans.io/api/introduction
name: Humaans
tags:
- Human Resources
- HRIS
- People Operations
- People Analytics
- Onboarding
- Offboarding
- Performance Management
- Time Off
- Compensation
- Workflow Automation
- AI Companion
- AI Agents
- United Kingdom
- London
tags_raw:
- HR
- HRIS
- Human Resources
- People Operations
- People Analytics
- Onboarding
- Offboarding
- Performance Management
- Time Off
- Compensation
- Workflow Automation
- AI Companion
- Agentic AI
- UK
- London
- Workflow-Automation
kind: contract
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: paid
onboarding: unknown
trial: false
try_now: false
public: false
label: Paid
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/humaans-io.png
access: 3rd-Party
common:
- type: Plans
url: plans/humaans-io-plans-pricing.yml
- type: CapabilityMap
url: capabilities/humaans-io-capability-edges.yml
name: Humaans Business Capability Map
- type: AgenticAccess
url: agentic-access/humaans-io-agentic-access.yml
- type: TrustCenter
url: security/humaans-io-trust-center.yml
- type: VulnerabilityDisclosure
url: security/humaans-io-vulnerability-disclosure.yml
- type: DomainSecurity
url: security/humaans-io-domain-security.yml
- type: Authentication
url: authentication/humaans-io-authentication.yml
- url: https://humaans.io
type: Portal
- url: https://humaans.io
name: Humaans Website
type: Website
- url: https://docs.humaans.io
name: Humaans Help Center
type: Documentation
- url: https://docs.humaans.io/api/
name: Humaans API Reference
type: Documentation
- url: https://docs.humaans.io/api/introduction
name: API Introduction
type: GettingStarted
- url: https://app.humaans.io
name: Humaans App
type: Login
- url: https://humaans.io/get-started
name: Get Started
type: Signup
- url: https://humaans.io/pricing
name: Pricing
type: Pricing
- url: https://humaans.io/integrations
name: Integrations Directory
type: Integrations
- url: https://humaans.io/security
name: Security
type: Security
- url: https://humaans.io/legal/privacy-policy
name: Privacy Policy
type: PrivacyPolicy
- url: https://humaans.io/legal/terms-of-service
name: Terms of Service
type: TermsOfService
- url: https://humaans.io/legal/dpa
name: Data Processing Agreement
type: Documentation
- url: https://humaans.io/legal/sub-processors
name: Sub-processors
type: Documentation
- url: https://humaans.io/blog
name: Humaans Blog
type: Blog
- url: https://humaans.io/customers
name: Customer Stories
type: CaseStudies
- url: https://humaans.io/about
name: About Humaans
type: About
- url: https://humaans.io/careers
name: Careers at Humaans
type: Careers
- url: https://humaans.io/contact
name: Contact
type: Contact
- url: mailto:hi@humaans.io
name: Humaans Support
type: Support
- url: https://www.linkedin.com/company/humaans
name: Humaans on LinkedIn
type: LinkedIn
- url: https://twitter.com/humaans_io
name: Humaans on X
type: Twitter
- url: https://github.com/humaans
name: Humaans on GitHub
type: GitHubOrganization
- url: https://github.com/humaans/figbird
name: figbird (Feathers data fetching for React)
type: SDKs
- url: https://github.com/humaans/next-img
name: next-img (Next.js image plugin)
type: SDKs
- url: https://github.com/humaans/react-machine
name: react-machine (state machine hook)
type: SDKs
- url: https://github.com/humaans/react-space-router
name: react-space-router (Space router for React)
type: SDKs
- url: https://github.com/humaans/workalendar
name: workalendar (worldwide holidays/workdays toolkit)
type: Tools
- url: https://apps.apple.com/app/humaans/id1610537316
name: Humaans iOS App
type: Application
- url: https://play.google.com/store/apps/details?id=io.humaans
name: Humaans Android App
type: Application
- url: https://www.g2.com/products/humaans/reviews
name: Humaans on G2
type: Review
- type: Features
data:
- 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
sources:
- https://humaans.io
- https://docs.humaans.io/api/
- https://docs.humaans.io/api/introduction
- https://humaans.io/integrations
- https://humaans.io/pricing
- https://github.com/humaans
updated: '2026-05-25'
created: '2026-05-25T00:00:00.000Z'
modified: '2026-05-25'
position: Producing
description: '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.
'
maintainers:
- FN: Kin Lane
email: info@apievangelist.com
X: apievangelist
url: https://apievangelist.com
specificationVersion: '0.23'
Humaans API — frequently asked questions
Does Humaans have an API?
Yes. APIs.io lists 15 APIs from Humaans, including Humaans Audit Events API, Humaans Bank Accounts API and Humaans Companies API, and 12 more.
Is there an OpenAPI specification for the Humaans API?
Yes. APIs.io indexes 15 OpenAPI specifications for Humaans, each linked for download from this page.
How do I authenticate with the Humaans API?
Humaans documents its authentication (http · 1 scheme). The details are profiled on APIs.io as Humaans Io Authentication.
How much does the Humaans API cost?
Humaans publishes its prices; its HRIS System of Record Growth plan is Talk to sales as of 2026-10-28. APIs.io lists 3 pricing plans for Humaans, with each plan's price, limits and inclusions under Pricing on this page.
Does Humaans have an MCP server?
Yes. APIs.io lists 1 MCP server for Humaans: Remote MCP server at mcp.humaans.io over HTTP.
Is the Humaans API ready for AI agents?
Humaans has a Kin Score of 53.9 out of 100 (developing) and an Agent Readiness score of 45.2 (agent-ready), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: