Humaans

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:
  - 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:
  - 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:
- 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
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/humaans-io.png
access: 3rd-Party
common:
- 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.16'