Skip to main content
GET

Authorizations

X-API-Key
string
header
required

Path Parameters

wabaId
string
required

WhatsApp Business Account ID.

Example:

"whatsapp-business-account-id"

phoneNumber
string
required

Phone number in E.164 format.

Example:

"+16315551111"

Response

Successfully retrieved the object.

WhatsApp Phone Number Business Profile. Customers can view your business profile by clicking your business's name or number in a conversation thread.

about
string

The business's About text. This text appears in the business's profile, beneath its profile image, phone number, and contact buttons.

Example:

"ABOUT"

ycloudName
string
read-only

Optional remark name assigned to this phone number in YCloud. It is populated by the profile GET API and omitted when no remark name is set.

Example:

"Support line"

verifiedName
string

The verified name

Example:

"verifiedName"

nameStatus
enum<string>

The review status of the current display name request. See also Get Display Name Status.

  • APPROVED: The name has been approved. You can download your certificate now.
  • AVAILABLE_WITHOUT_REVIEW: The certificate for the phone is available and display name is ready to use without review.
  • DECLINED: The name has not been approved. You cannot download your certificate.
  • EXPIRED: Your certificate has expire and can no longer be downloaded.
  • PENDING_REVIEW: Your name request is under review. You cannot download your certificate.
  • NONE: No certificate is available.
Available options:
APPROVED,
AVAILABLE_WITHOUT_REVIEW,
DECLINED,
EXPIRED,
PENDING_REVIEW,
NONE
newName
string

The modified name

Example:

"John's Cake"

newNameStatus
enum<string>

The review status of the current display name request. See also Get Display Name Status.

  • APPROVED: The name has been approved. You can download your certificate now.
  • AVAILABLE_WITHOUT_REVIEW: The certificate for the phone is available and display name is ready to use without review.
  • DECLINED: The name has not been approved. You cannot download your certificate.
  • EXPIRED: Your certificate has expire and can no longer be downloaded.
  • PENDING_REVIEW: Your name request is under review. You cannot download your certificate.
  • NONE: No certificate is available.
Available options:
APPROVED,
AVAILABLE_WITHOUT_REVIEW,
DECLINED,
EXPIRED,
PENDING_REVIEW,
NONE
address
string

Address of the business. Character limit 256.

Maximum string length: 256
Example:

"ADDRESS"

description
string

Description of the business. Character limit 512.

Maximum string length: 512
Example:

"DESCRIPTION"

email
string

The contact email address (in valid email format) of the business. Character limit 128.

Maximum string length: 128
Example:

"tom@example.com"

profilePictureUrl
string

URL of the profile picture used to upload to Meta.

Example:

"https://URL"

vertical
enum<string>

Industry of the WhatsApp phone number business profile. This can be either an empty string or one of the accepted values.

Available options:
OTHER,
AUTO,
BEAUTY,
APPAREL,
EDU,
ENTERTAIN,
EVENT_PLAN,
FINANCE,
GROCERY,
GOVT,
HOTEL,
HEALTH,
NONPROFIT,
PROF_SERVICES,
RETAIL,
TRAVEL,
RESTAURANT
Example:

"OTHER"

websites
string[]

The URLs associated with the business. For instance, a website, Facebook Page, or Instagram. You must include the http:// or https:// portion of the URL. There is a maximum of 2 websites with a maximum of 255 characters each.

Maximum array length: 2
Maximum string length: 255