aid: humaans-io
url: https://raw.githubusercontent.com/api-evangelist/humaans-io/refs/heads/main/apis.yml
apis:
- aid: humaans-io:humaans-api
  name: Humaans API
  tags:
  - HR
  - HRIS
  - Human Resources
  - People Operations
  - Employees
  - Time Off
  - Compensation
  - Payroll
  - Onboarding
  - Performance
  - Timesheets
  - Webhooks
  humanURL: https://docs.humaans.io/api/
  baseURL: https://app.humaans.io/api
  properties:
  - url: https://docs.humaans.io/api/
    type: Documentation
  - url: https://docs.humaans.io/api/introduction
    type: Documentation
  - url: openapi/humaans-api-openapi.yml
    type: OpenAPI
  description: |
    REST API for the Humaans HRIS exposing People, Companies, Compensations,
    Bank Accounts, Documents, Time Away (entries, allocations, policies, types),
    Equipment, Job Roles, Locations, Custom Fields and Values, Performance
    (reviews, cycles, templates, ratings), Timesheet entries and submissions,
    Webhooks, Audit Events, and Working Patterns. Bearer token authentication
    with OAuth-style scopes (public:read, private:read, private:write,
    compensations:read/write, documents:read/write, webhooks:manage). JSON in /
    JSON out, standard HTTP verbs, $limit/$skip pagination, $in/$nin/$gt/$gte/$lt/$lte/$or
    filter operators, and HMAC SHA-256 signed webhook deliveries with retry and
    automatic disablement after 5 days of failures.
name: Humaans
tags:
- HR
- HRIS
- Human Resources
- People Operations
- People Analytics
- Onboarding
- Offboarding
- Performance Management
- Time Off
- Compensation
- Workflow Automation
- AI Companion
- Agentic AI
- UK
- London
kind: contract
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
- 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: SignIn
- 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: SDK
- url: https://github.com/humaans/next-img
  name: next-img (Next.js image plugin)
  type: SDK
- url: https://github.com/humaans/react-machine
  name: react-machine (state machine hook)
  type: SDK
- url: https://github.com/humaans/react-space-router
  name: react-space-router (Space router for React)
  type: SDK
- url: https://github.com/humaans/workalendar
  name: workalendar (worldwide holidays/workdays toolkit)
  type: Tool
- 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: Reviews
- 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.16'