Overview
Humanos is an API designed to bring human authorization into automated workflows. It enables digital systems - APIs, workflows, and autonomous agents - to verify in real time whether a human has approved an action. If an authorization is missing, Humanos can immediately request it through a secure, unified flow, ensuring that processes never stall due to compliance checks or pending approvals. By turning human decisions into programmable, verifiable events, Humanos allows organizations to automate more confidently, reduce operational friction, and maintain full traceability of every authorization involved in a business process.Get Started
Create your account and start building with Humanos. Set up your API keys,
configure webhooks, and begin integrating human authorization into your
automated workflows.
API Reference
Browse the complete API reference to see how DIDs and VCs are used in practice
when working with the Humanos API.
Authentication
Learn how to authenticate with the API and understand the security mechanisms that protect your integrations.
W3C DIDs and VCs
Every entity in the Humanos ecosystem - automated systems, organizations, and end users - is identified using a Decentralized Identifier (DID) compliant with the W3C DID standard. This ensures globally unique, verifiable identities without relying on centralized identity providers. All authorizations collected through Humanos are encapsulated as W3C Verifiable Credentials (VC) 2.0. This gives each authorization a cryptographic proof, a tamper-evident structure, and a complete audit trail. As a result, every action performed on the platform - whether a signature, consent, mandate approval, or identity verification - is securely verifiable and traceable end-to-end.Learn about DIDs
Understand how Decentralized Identifiers work and how they enable globally unique, verifiable identities in the Humanos ecosystem.
Learn about VCs
Explore W3C Verifiable Credentials and how they provide cryptographic proof
and tamper-evident structures for all authorizations.
Requests
A request is composed of a collection of authorizations that can be sent to one or multiple users through a secure link, which can be shared over any channel. Each authorization represents a specific human action your automated system needs in order to continue its workflow. Humanos supports several types of authorizations, including:- Identity Validations (KYC): Verify a user’s identity using a government-issued ID scan combined with a selfie.
- Signature Requests: Present PDFs for users to review, sign, or reject.
- Consents: Collect required or optional consents, with support for embedded external resources.
- Form Filling: Build and manage structured forms for users to complete.
- Mandates: A flexible, JSON-based authorization format that allows automated systems to request and collect arbitrary approvals from humans, enabling highly customizable decision flows.