---
title: "Number Retrieval DCQL Request"
method: POST
path: "/camara/number-verification/v2/dcql/device-phone-number"
tags: ["connectivity", "camara", "number-retrieval"]
---

# Number Retrieval DCQL Request

`POST /camara/number-verification/v2/dcql/device-phone-number`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/camara/number-verification/v2/dcql/device-phone-number`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to generate a credential request structure for the Android CredentialManager for the SIM-based (TS.43) number retrieval use case. The response must be passed to the device for SIM-based (TS.43) authentication.

## Request body

- C4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17aeDcqlUseCaseRequestDto
  - `nonce` string, required: A single-use, client generated value. The client keeps it and uses it to correlate the eventual response. Infobip embeds this same value in the credential_authorization_jwt payload.
  - `carrierIds` integer[], required: Array of Android canonical carrier IDs.

## Response `200`

OK — per-carrier map of DCQL credential objects or error objects

- union
  - C4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17aeDcqlResponseDto: Map of resolved DCQL credential objects keyed by carrier ID, used to build the credential request structure for the Android CredentialManager (TS.43 SIM-based authentication). If one or more requested carriers could not be resolved, their error responses will be returned in the same map. For unresolved carrier response structure, see `DCQL Carrier Error Map` section.
  - C4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17aeDcqlNotFoundErrorResponse: Map of DCQL error responses keyed by carrier ID, returned when one or more requested carriers could not be resolved. Resolved carriers will be returned in the same map. For resolved carrier response structure, see `DCQL Credential Map` section.

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Platform authentication error
- `403`: Permission denied
- `422`: Unprocessable content
- `500`: Internal server error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)