Humanos wins Mastercard For Fintechs 2026 competition
HumanosHumanos
Start
Get API keys
Create production credentials
Quickstart
5-minute integration
Dashboard
Manage mandates & receipts
API reference
All endpoints & types
VIAComing soon
Open verification protocol
SDKs
TypeScript
npm install humanos
Python
pip install humanos
C#
dotnet add Humanos
Orchestration
n8nComing soon
Drop verify() into low-code workflows
ZapierComing soon
Trigger-based agent automation
SkillsComing soon
Reusable verify() modules for LLM agents
Core
humanos.verify()
Verify before execution
Requesting approvals
Capture approval at runtime
Revocation
Invalidate credentials
Webhooks
Event-driven integration

Product updates

Changelog

What changed in each dated version of the Humanos platform, newest first. The API is versioned by date — integrations pin a version with the API-Version header and upgrade on their own schedule, so a new version never changes behaviour you depend on until you opt in. Full technical detail lives in the API documentation.

2026-07-06 — Latest

Richer catalog and audit surfaces; leaner verification shapes.

  • Actions: GET /actions and GET /actions/version/{id} now return the full catalog shape — action name and description, version list, per-version content, published flag and a digestSRI integrity hash, with standard pagination.
  • Credentials: the credential entity gains name, description, tags and decisions.
  • Verifiable presentations (breaking): issue/verify shapes simplified — the presentation response no longer nests presentationEncoded/receipt, and verification takes the presentation in its new form.
  • Requests (breaking): the iframe object was removed from POST /request — iframe embedding is configured through the iframe integration guide instead.
  • Subjects: extraContacts and identity handling refined on POST /user.

2026-06-18

Multi-user requests and a structured identity webhook.

  • Multi-user requests (breaking): POST /request now takes a users[] array — each entry with its own contact, secondary contact, document id, language and signer quality.
  • Embedding (breaking): iframe configuration moved into the request body; the top-level pubKey and redirectUrl fields were removed.
  • Identity webhook (breaking): the flat identity payload became a structured document — addresses, birth, nationality, document type, issue date, expiry and more as first-class fields. Pin your webhook version before upgrading.
  • Filtering: dateFrom/dateTo range filters normalised on GET /request and GET /activity.

2026-05-17

The platform surface: credentials, actions, DIDs, approvals, activity, webhooks.

  • New endpoint groups: Credentials (evidence, issue VP, verify, revoke), Actions, DID resolution, Approvals (replacing Resources), Activity, and documented webhook event schemas.
  • Idempotency: Idempotency-Key header support on POST /request, POST /user and PATCH /request/resend/{requestId} — safe retries without duplicate side effects.
  • Lookups (breaking): users are addressed by id (previously did); request listing filters by subject.

2026-03-20

Initial public version.

  • Requests: create, list, fetch, delete, and OTP resend.
  • Users: create and look up.
  • Credentials: fetch by id.
  • Resources: list resources and resource groups (renamed to Approvals in 2026-05-17).

Staying informed

Breaking changes are only ever introduced behind a new dated version. Questions about an upgrade, or something behaving differently than these notes describe? Email support@humanos.tech and we will help you move across.