Call Personalization Batch v2 Status

Each record indicates whether the record was successfully pushed or not.

Replace the {{BaseURL}} with the one mentioned here

GET {{BaseURL}}/v2/clients/{clientAccountId}/dynamic_call_records

{clientAccountId} : This can be taken directly from the self serve portal under the Manage API Keys Page

For Authorization Token kindly refer the Authentication section followed by Generate Access Token API

Headers

Name	Value
Content-Type	Required application/json
Authorization	Required Bearer <token>

Query Parameter

Name	Value	Type
batchId	Required This is received from the Create Dynamic Call Records API response	string

Response

200 OK

{
    "client_account_id": "91c173bb-28d8-4030-9722-8663ff9589f3",
    "batch_id": "0ca10281-11a0-4f86-bb27-7452da543cb6",
    "data": [
        {
            "id": "c458227a-a730-4ced-81b4-19c21ea8d97c",
            "caller_number": "[phone]",
            "receiver_number": "914567867865",
            "label_id": "c6d86658-008d-4c08-98fb-2bf2649d59a5",
            "dynamic_label_name": "Centro Bank KYC Department",
            "dynamic_call_reason": "Calling you for KYC Verification",
            "starts_at": 1753246858000,
            "ends_at": 1753362058000,
            "status_info": {
                "status": "success"
            },
            "created_at": "2025-07-23T09:07:32.21Z"
        }
    ]
}

401 Unauthorized

{
    "slug": "authorization-error",
    "message": "please login again"
}

Name	Type	Validations	Description
client_account_id	string	NA	Client account id of the account.
batch_id	string	NA	Identifier of the created batch. Use this with the Get Dynamic Call Records by Batch endpoint to poll per-record processing status. Example"5909638a-a8a7-4a86-8970-d576e9717887"
dynamic_call_reason	string	minLength: 10 maxLength: 100	Optional. The call reason to be displayed.
id	string	NA	Unique identifier of the individual dynamic call record (distinct frombatch_id, which groups multiple records).
caller_number	string	Format Supported:"[phone]"	Required The phone number of the caller, in E.164 format.
ends_at	integer (int64)	Epoch timestamp in milliseconds	Required The timestamp, in milliseconds, at which the dynamic caller ID should expire. Must not be in the past and must be no more than 24 hours after starts_at
label_id	string	NA	Optional The label ID of the dynamic label to be used as the caller ID. Must belong to the client account.
dynamic_label_name	string	minLength: 3 maxLength: 40	Optional The caller ID name to be displayed. If omitted, defaults to the name of the provided label.
receiver_number	string	Format Supported:"[phone]"	Required The phone number of the receiver, in E.164 format.
starts_at	integer (int64)	Epoch timestamp in milliseconds	Required The timestamp, in milliseconds, at which the dynamic caller ID should start reflecting.
status_info	object	NA
status	string	NA	Processing status of the record or request. Possible Enum #0"success" #1"error" #2"initiated" #3"validated" Example"success"
message	string	NA	Human-readable status or error message. Example"Record processed successfully"
created_at	string	NA	Server-assigned UTC timestamp of when the record was created