> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humanos.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity Event

> Fired when an identity verification (KYC) decision is reached.

**Inbound webhook callback** — Humanos POSTs this payload to your registered webhook URL. This is not an endpoint you call; it is documented as a path so SDK code generators emit a typed payload model.



## OpenAPI

````yaml /versions/2026-07-06.yaml post /_webhooks/identity
openapi: 3.1.0
info:
  title: Humanos API
  description: Humanos API
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: humanosApp
    description: ''
paths:
  /_webhooks/identity:
    post:
      tags:
        - Webhooks
      summary: Identity Event
      description: >-
        Fired when an identity verification (KYC) decision is reached.


        **Inbound webhook callback** — Humanos POSTs this payload to your
        registered webhook URL. This is not an endpoint you call; it is
        documented as a path so SDK code generators emit a typed payload model.
      operationId: webhooks_identity
      parameters:
        - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IdentityEvent'
      responses:
        '200':
          description: Webhook received successfully
components:
  parameters:
    ApiVersion:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        example: '2026-07-06'
      description: >-
        Pin request, response, and webhook shapes to a specific dated API
        version (YYYY-MM-DD). Omit to use the version pinned to your API key
        (set when the key is created; new keys default to the latest version).
        New integrations should target the latest version.
  schemas:
    IdentityEvent:
      type: object
      properties:
        eventType:
          type: string
          enum:
            - identity
        requestId:
          type: string
        internalId:
          type: string
        issuerDid:
          type: string
        user:
          type: object
          properties:
            contact:
              type: string
            id:
              type: string
            internalId:
              type: string
          required:
            - contact
            - id
          additionalProperties: false
        api_version:
          type: string
        identity:
          $ref: '#/components/schemas/IdentityWebhook'
        decision:
          type: object
          properties:
            success:
              type: boolean
            message:
              type: string
            date:
              type: string
              format: date-time
          required:
            - success
            - date
          additionalProperties: false
      required:
        - api_version
        - decision
        - eventType
        - issuerDid
        - requestId
        - user
      additionalProperties: false
    IdentityWebhook:
      type: object
      additionalProperties: false
      properties:
        nationality:
          type: string
        placeOfBirth:
          type: string
        addresses:
          type: array
          items:
            type: string
        height:
          type: number
        weight:
          type: number
        documentType:
          type: string
        issueDate:
          anyOf:
            - type: string
              format: date-time
            - type: string
        expiresAt:
          anyOf:
            - type: string
              format: date-time
            - type: string
        placeOfIssue:
          type: string
        fullName:
          type: string
        gender:
          nullable: true
          type: string
        birth:
          type: string
          format: date-time
        docId:
          type: string
        fullDocId:
          type: string
        countryAlpha3:
          type: string
      required:
        - birth
        - countryAlpha3
        - docId
        - fullDocId
        - fullName

````