---
title: "Get Whatsapp Phone Details"
method: POST
path: "/v1/integrations/whatsapp/profile/{profile_id}/phone-details"
tags: ["Integrations", "WhatsApp"]
---

# Get Whatsapp Phone Details

`POST /v1/integrations/whatsapp/profile/{profile_id}/phone-details`

## Request

- Base URL: `https://client.api.prod.orsay.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://client.api.prod.orsay.ai/v1/integrations/whatsapp/profile/{profile_id}/phone-details`
- Auth: HTTP bearer

Get details for a specific WhatsApp phone number or all phone numbers in the profile's business account.

Args:
    profile_id: The UUID of the WhatsApp profile
    request: Contains optional target phone number, optional business account ID, and optional encrypted token
    auth_result: Authentication token

Returns:
    - WhatsappPhoneDetailsResponse: If TargetPhoneNumber is provided and found
    - WhatsappPhoneNumbersListResponse: If TargetPhoneNumber is not provided (returns all phone numbers)
    - None: If TargetPhoneNumber is provided but not found

## Path parameters

- `profile_id` string, uuid, required

## Request body

- WhatsappPhoneDetailsRequest
  - `TargetPhoneNumber` string, nullable
  - `TargetBusinessAccountID` string, nullable
  - `AccessToken` string, nullable

## Response `200`

Successful Response

- union
  - WhatsappPhoneDetailsResponse
    - `PhoneID` string, required
    - `DisplayPhoneNumber` string, required
    - `VerifiedName` string, nullable
    - `CodeVerificationStatus` string, nullable
    - `QualityRating` string, nullable
  - WhatsappPhoneNumbersListResponse
    - `PhoneNumbers` WhatsappPhoneDetailsResponse[], required
      - `PhoneID` string, required
      - `DisplayPhoneNumber` string, required
      - `VerifiedName` string, nullable
      - `CodeVerificationStatus` string, nullable
      - `QualityRating` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orsay/apis/orsay-api.md) - [All operations](https://skmtc.dev/orsay/apis/orsay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orsay/apis/orsay-api/revisions/988a26cafef5?raw)