Skip to main content
POST
/
v1
/
credentials
/
verify
Verify a credential
curl --request POST \
  --url https://api.example.com/v1/credentials/verify \
  --header 'Content-Type: application/json' \
  --data '
{
  "credential": "<string>",
  "context": {
    "resource_type": "<string>",
    "resource_id": "<string>",
    "action": "<string>",
    "transaction_amount": 1,
    "transaction_currency": "<string>",
    "merchant_category": "<string>",
    "merchant_id": "<string>",
    "time_of_day": "<string>",
    "user_country": "<string>",
    "audience": "<string>"
  },
  "by_credential_id": "<string>"
}
'
{
  "credential_id": "<string>",
  "issuer_did": "<string>",
  "subject": {
    "id": "<string>",
    "registration_number": "<string>",
    "jurisdiction": "<string>",
    "legal_form": "<string>"
  },
  "issued_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "verified_at": "2023-11-07T05:31:56Z",
  "verification_id": "<string>",
  "attestation_type": "<string>",
  "policy_match": {
    "matched": true,
    "permission_index": 1,
    "conditions_evaluated": [
      {
        "field": "<string>",
        "op": "<string>"
      }
    ],
    "deny_reason": "<string>"
  },
  "evidence_refs": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.beltic.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
credential
string
required
Minimum string length: 1
context
object
by_credential_id
string

Response

Verification result — valid: true on success, valid: false with reason on domain-level failure

valid
enum<boolean>
required
Available options:
true
credential_id
string
required
credential_type
enum<string>
required
Available options:
business,
user,
agent_authorization,
outcome_attestation
issuer_did
string
required
subject
object
required
issued_at
string<date-time>
required
expires_at
string<date-time>
required
verified_at
string<date-time>
required
status
enum<string>
required
Available options:
active,
revoked,
expired,
suspended
verification_id
string
required
attestation_type
string
trust_level
enum<string>
Available options:
self_attested,
liveness_verified,
idv_verified,
enterprise_verified
policy_match
object
evidence_refs
string[]
Maximum array length: 50
Required string length: 1 - 512