Skip to main content
GET
/
whatsapp
/
phone_numbers
/
{phone_number_id}
/
display_name_requests
List display name requests
curl --request GET \
  --url https://api.kapso.ai/platform/v1/whatsapp/phone_numbers/{phone_number_id}/display_name_requests \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "2b0f4a1e-7a58-4a15-b0c9-0d7f1a2b3c4d",
      "whatsapp_config_id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d",
      "requested_display_name": "Acme Support",
      "previous_display_name": "+1 555-123-4567",
      "status": "applied",
      "submitted_at": "2025-07-14T15:00:00Z",
      "reviewed_at": "2025-07-15T12:34:00Z",
      "applied_at": "2025-07-16T09:00:00Z",
      "meta_error_code": null,
      "meta_error_subcode": null,
      "meta_error_type": null,
      "meta_error_message": null
    },
    {
      "id": "8c9d0e1f-2a3b-4c5d-6e7f-8a9b0c1d2e3f",
      "whatsapp_config_id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d",
      "requested_display_name": "TechCorp Customer Service",
      "previous_display_name": "Acme Support",
      "status": "pending_review",
      "submitted_at": "2025-07-20T10:30:00Z",
      "reviewed_at": null,
      "applied_at": null,
      "meta_error_code": null,
      "meta_error_subcode": null,
      "meta_error_type": null,
      "meta_error_message": null
    },
    {
      "id": "3f4a5b6c-7d8e-9f0a-1b2c-3d4e5f6a7b8c",
      "whatsapp_config_id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d",
      "requested_display_name": "ACME Inc",
      "previous_display_name": "+1 555-123-4567",
      "status": "declined",
      "submitted_at": "2025-06-15T08:00:00Z",
      "reviewed_at": "2025-06-16T14:22:00Z",
      "applied_at": null,
      "meta_error_code": 100,
      "meta_error_subcode": 2388135,
      "meta_error_type": "OAuthException",
      "meta_error_message": "Display name does not match business verification details"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 3,
    "per_page": 20
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

phone_number_id
string
required

Query Parameters

per_page
integer
Required range: x >= 1
page
integer
Required range: x >= 1

Response

Display name requests retrieved

data
object[]
required
meta
object
required