# Humanos API Docs ## Docs - [Get Actions](https://docs.humanos.id/api-reference/2026-05-17/actions/get-actions.md): Retrieve actions for the authenticated organization. Only published versions are ever exposed here; drafts are hidden from public clients. - [Get Versions](https://docs.humanos.id/api-reference/2026-05-17/actions/get-versions.md): Retrieve published versions of an action. Drafts are hidden from public clients. - [List Activity Events](https://docs.humanos.id/api-reference/2026-05-17/activity/list-activity-events.md): Retrieve a paginated list of activity events for your organization. Events are returned in descending chronological order (most recent first). Filter by event type, entity, actor / subject DID, or date range. Payload schemas vary by event `type` — see the `ActivityEventPayloads` type in `@huma… - [Get Approvals](https://docs.humanos.id/api-reference/2026-05-17/approval/get-approvals.md): Retrieve a paginated list of your approvals. Approvals can be documents, consents, forms. - [List Workflows](https://docs.humanos.id/api-reference/2026-05-17/approval/list-workflows.md): Retrieve a paginated list of your workflows, including their approvals. Workflows allow to pack approvals together and easily request them. - [Get Credential](https://docs.humanos.id/api-reference/2026-05-17/credentials/get-credential.md): Retrieve a credential by its identifier, including the full W3C Verifiable Credential, and the latest status of all grantor decisions. - [Get evidence](https://docs.humanos.id/api-reference/2026-05-17/credentials/get-evidence.md) - [Issue VP](https://docs.humanos.id/api-reference/2026-05-17/credentials/issue-vp.md): Build and sign a W3C Verifiable Presentation for a stored credential. The API key must belong to the credential owner. - [Revoke Credential](https://docs.humanos.id/api-reference/2026-05-17/credentials/revoke-credential.md): Permanently revoke an active credential. Flips status to REVOKED, records revokedAt and revocationReason, Issues a MANDATE_REVOKED receipt, and emits a MANDATE_REVOKED activity event. Subsequent /vp and /verify calls for this credential are denied with reason credential_revoked. - [Verify VP](https://docs.humanos.id/api-reference/2026-05-17/credentials/verify-vp.md): Evaluate a VP against runtime context. On allow, returns 200 with the signed receipt. On deny, returns 403 with the reason, evaluations, and receipt in the error body. If the mandate has no constraint schema, only signatures, verifier access, and validity are checked. - [Resolve DID](https://docs.humanos.id/api-reference/2026-05-17/did/resolve-did.md): Resolve a DID string to a W3C DID 1.1 Document. - [Cancel Request](https://docs.humanos.id/api-reference/2026-05-17/requests/cancel-request.md): This action will cancel a credential request. Once a request is canceled, it cannot be undone and will prevent the request from being completed by any subjects. A request can be canceled if it contains credentials in draft status. - [Create Request](https://docs.humanos.id/api-reference/2026-05-17/requests/create-request.md): Create a new request for one or more subjects (users). This endpoint will: - Create credentials from resources (via group IDs, resource IDs) or inline JSON data - Associate those credentials with subjects - Generate and send OTPs via email or SMS - [Get Detail](https://docs.humanos.id/api-reference/2026-05-17/requests/get-detail.md): Retrieve detailed information about a specific credential request Just like the list requests endpoint, this endpoint includes information about the request, credentials, subjects (users) and chosen security level However, this endpoint includes the full W3C Verifiable Credential data for each c… - [List Requests](https://docs.humanos.id/api-reference/2026-05-17/requests/list-requests.md): Retrieve a paginated list of your credential requests Each request includes information about the request, credentials, subjects (users) and chosen security level - [Resend OTP](https://docs.humanos.id/api-reference/2026-05-17/requests/resend-otp.md): Resend a One-Time Password (OTP) to a subject for credential approval, via email or SMS (depending on their contact type) with a code and a signing URL. The endpoint validates: - The request is not canceled - Maximum attempts have not been reached, only successful OTP sends count towards re… - [Create User](https://docs.humanos.id/api-reference/2026-05-17/user/create-user.md): This endpoint allows organizations to import their existing users information into Humanos, for better management and control. - Multiple users can be created in a call. - A user is identified by a Humanos verified contact (email or phone), if doesn't exist will be created. - Optionally, ad… - [Get User](https://docs.humanos.id/api-reference/2026-05-17/user/get-user.md): Retrieves detailed information about a user. Search by exactly one parameter: contact, id, or internalId. Only one must be provided. - [Credential Event](https://docs.humanos.id/api-reference/2026-05-17/webhooks/credential-event.md): Fired when a credential request is accepted or rejected by the subject. - [Identity Event](https://docs.humanos.id/api-reference/2026-05-17/webhooks/identity-event.md): Fired when an identity verification (KYC) decision is reached. - [OTP Failed Event](https://docs.humanos.id/api-reference/2026-05-17/webhooks/otp-failed-event.md): Fired when an OTP delivery to the subject fails. - [Test Event](https://docs.humanos.id/api-reference/2026-05-17/webhooks/test-event.md): Fired when a webhook test is triggered from the dashboard. - [Authentication](https://docs.humanos.id/essentials/authentication.md): Learn how to authenticate with the Humanos API using API keys and request signing - [Iframe Integration](https://docs.humanos.id/essentials/iframe-integration.md): Embed the Humanos Link flow in an iframe and receive encrypted real-time results via postMessage - [Introduction](https://docs.humanos.id/essentials/introduction.md): A cryptographic permission slip per agent action — issued by the user, scoped to a specific action, verified at runtime. - [Quick Start](https://docs.humanos.id/essentials/quick-start.md): End-to-end walkthrough — define an action, collect approval, issue VPs, verify, and revoke. - [Versioning](https://docs.humanos.id/essentials/versioning.md): How Humanos API versions works, how to pin a version, and what happens when you don't - [Webhooks](https://docs.humanos.id/essentials/webhooks-intro.md): Receive real-time notifications about request events and user actions ## OpenAPI Specs - [2026-05-17](https://docs.humanos.id/versions/2026-05-17.yaml) - [2026-03-20](https://docs.humanos.id/versions/2026-03-20.yaml) - [openapi](https://docs.humanos.id/openapi.yaml) - [humanos-api](https://docs.humanos.id/humanos-api.yml)