Create verification

curl --request POST \
  --url https://api.beltic.com/v1/identity/verifications \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "data": {
    "type": "verification/idv",
    "relationships": {
      "session": {
        "data": {
          "type": "session",
          "id": "123e4567-e89b-12d3-a456-426614174000"
        }
      },
      "document": {
        "data": {
          "type": "document/idv",
          "id": "223e4567-e89b-12d3-a456-426614174000"
        }
      }
    },
    "meta": {
      "auto_update_session": true
    }
  }
}
'

{
  "data": {
    "id": "<string>",
    "type": "<string>",
    "attributes": {},
    "relationships": {},
    "meta": {}
  }
}

Identity API — Verifications (Legacy)

Create Verification

Create a new verification request. Processing is performed synchronously.

The data.type field determines the verification type and must be one of:

verification/idv: Identity document verification (requires a document/idv relationship)
verification/address: Address document verification (requires a document/address relationship)
verification/business: Business verification / KYB (requires a business relationship)

The session relationship is optional. When meta.auto_update_session is true, a session must be provided and will be updated with the extracted data upon a passing verification.

Meta options:

auto_update_session: When true and the verification passes, the session is automatically updated with the extracted information. Requires a session relationship.

POST

identity

verifications

Create verification

curl --request POST \
  --url https://api.beltic.com/v1/identity/verifications \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "data": {
    "type": "verification/idv",
    "relationships": {
      "session": {
        "data": {
          "type": "session",
          "id": "123e4567-e89b-12d3-a456-426614174000"
        }
      },
      "document": {
        "data": {
          "type": "document/idv",
          "id": "223e4567-e89b-12d3-a456-426614174000"
        }
      }
    },
    "meta": {
      "auto_update_session": true
    }
  }
}
'

{
  "data": {
    "id": "<string>",
    "type": "<string>",
    "attributes": {},
    "relationships": {},
    "meta": {}
  }
}

Authorizations

X-Api-Key

string

header

required

API key for authentication. Access https://console.beltic.com/ to obtain your API key.

Body

application/json

data

verification/idv · object

required

verification/idv
verification/address
verification/business

Show child attributes

Example:

{
  "type": "verification/idv",
  "relationships": {
    "session": {
      "data": {
        "type": "session",
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    },
    "document": {
      "data": {
        "type": "document/idv",
        "id": "223e4567-e89b-12d3-a456-426614174000"
      }
    }
  },
  "meta": { "auto_update_session": true }
}

Response

Verification created and processed successfully

data

object

required

Show child attributes

Submit Document Address

List Verifications

⌘I