Skip to main content
POST
/
certificates
/
phone_number_verification
/
query
Query phone number verification certificate data for a consumer
curl --request POST \
  --url https://api.example.com/certificates/phone_number_verification/query \
  --header 'Content-Type: application/json' \
  --data '
{
  "consent_id": "<string>",
  "consumer_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "query_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "consumer_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "phone_number_verification": {
    "furnishing_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assertions": {
      "phone_number_verification_assertion": true,
      "phone_number_verification_timestamp": "2023-11-07T05:31:56Z"
    },
    "data": {
      "phone_number": "<string>",
      "phone_number_format": "<string>",
      "phone_carrier_name": "<string>",
      "phone_to_identity_provider_verification_sources": [
        "<string>"
      ],
      "phone_to_identity_provider_match_signals": [
        "<string>"
      ],
      "phone_to_identity_provider_validation_outcome": "<string>"
    }
  }
}

Body

application/json

Consent token — system resolves identity + applies field access filtering.

consumer_entity_id
string<uuid> | null

Direct entity lookup for permissible-purpose (FCRA) queries.

Response

Successful Response

query_event_id
string<uuid>
required
consumer_entity_id
string<uuid>
required
phone_number_verification
PhoneNumberVerificationSubProduct · object