--- title: "Retrieve a WABA" method: GET path: "/whatsapp/businessAccounts/{id}" tags: ["WhatsApp Business Accounts"] --- # Retrieve a WABA `GET /whatsapp/businessAccounts/{id}` Retrieves a WABA you've registered. ## Path parameters - `id` string, required ## Response `200` Successfully retrieved the WABA. - WhatsappBusinessAccount — Represents a specific [WhatsApp Business Account (WABA)](https://developers.facebook.com/docs/whatsapp/overview/business-accounts). - `id` string — WhatApp Business Account ID. - `name` string — User-friendly name to differentiate WhatsApp Business Accounts. - `currency` string — The currency in which the payment transactions for the WhatsApp Business Account will be processed. - `messageTemplateNamespace` string — Namespace string for the message templates that belong to the WhatsApp Business Account. - `accountReviewStatus` 'PENDING' | 'APPROVED' | 'REJECTED' — WhatsApp Business Account review status. - `businessVerificationStatus` 'expired' | 'failed' | 'ineligible' | 'not_verified' | 'pending' | 'pending_need_more_info' | 'pending_submission' | 'rejected' | 'revoked' | 'verified' — Current status of business verification of Meta Business Account which owns this WhatsApp Business Account. - `country` string — Country of the WhatsApp Business Account's owning Meta Business account. - `ownershipType` string — Ownership type of the WhatsApp Business Account. - `paymentMethodAttached` boolean — Whether we have attached a payment method to the WhatsApp Business Account. - `primaryFundingId` string — Primary funding ID for the WhatsApp Business Account paid service. - `purchaseOrderNumber` string — The purchase order number supplied by the business for payment management purposes. - `timezoneId` string — The timezone ID of the WhatsApp Business Account. See [Timezone IDs](https://developers.facebook.com/docs/marketing-api/reference/ad-account/timezone-ids). - `decision` 'APPROVED' | 'REJECTED' — Used if a decision about WhatsApp accounts or phone numbers has been made. - `updateEvent` 'DISABLED_UPDATE' | 'ACCOUNT_RESTRICTION' | 'ACCOUNT_VIOLATION' | 'PARTNER_REMOVED' | 'PARTNER_APP_UNINSTALLED' | 'AUTH_INTL_PRICE_ELIGIBILITY_UPDATE' | 'BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE' — Indicates the update event type of the WABA when a notification is sent to you to report a [policy violation](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement), a WABA has been banned and more. - `DISABLED_UPDATE`: WhatsApp Business Account Banned. - `ACCOUNT_RESTRICTION`: WhatsApp Business Account Restricted Due To Policy Violations. - `ACCOUNT_VIOLATION`: WhatsApp Business Account Violates Policy. - `PARTNER_REMOVED`: WhatsApp Business Account was removed from the partner connection. - `PARTNER_APP_UNINSTALLED`: WhatsApp Business Account partner app was uninstalled. - `AUTH_INTL_PRICE_ELIGIBILITY_UPDATE`: WhatsApp Business Account is eligible for the [authentication-international rate](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates). - `BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE`: Business's [primary business location](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates#primary-business-location) is set. - `banState` 'SCHEDULE_FOR_DISABLE' | 'DISABLE' | 'REINSTATE' — The ban state of the WhatsApp Business Account. - `banDate` string — The date when the WABA is banned. - `violationType` string — Used to report violations imposed on the WABA. See also [WhatsApp Business Platform Policy Violations](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement/violations). - `restrictions` WhatsappBusinessAccountRestrictionInfo[] — Used to report restrictions imposed on the WABA, when that WABA violates [WhatsApp Business Platform policies](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement). - `restrictionType` 'RESTRICTED_ADD_PHONE_NUMBER_ACTION' | 'RESTRICTED_BIZ_INITIATED_MESSAGING' | 'RESTRICTED_CUSTOMER_INITIATED_MESSAGING' — Restriction type. - `expiration` string, date-time — The time at which this restriction expires, formatted in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). e.g., `2022-06-01T12:00:00.000Z`. - `authIntlRateEligibilityCountries` WhatsappAuthIntlRateEligibilityCountry[] — Starting June 1, 2024, we are updating our authentication rate card and introducing a new authentication-international rate. This rate will apply in the the following countries: - June 1, 2024 – Indonesia (country calling code +62, country code `ID`) - July 1, 2024 – India (country calling code +91, country code `IN`) See also [Authentication-International Rates](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates). - `countryCode` string — [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `startTime` string, date-time — Date when newly-opened authentication conversations are subject to authentication-international rates, formatted in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). e.g., `2024-07-01T00:00:00.000Z`. - `primaryBusinessLocation` string — Your primary business location is the country where your business is based. It will appear in the Business Manager under the Primary Business Location field starting May 1, 2024. [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `removedReason` string — Raw reason from the WhatsApp Business Account deletion event. Known values include: - `ACCOUNT_DISCONNECTED`: The account was disconnected due to enforcement or because the WhatsApp account was explicitly deleted. - `BUSINESS_DOWNGRADE`: The phone number was registered with the consumer WhatsApp app. - `CHANGE_NUMBER`: The WhatsApp phone number was changed. - `COMPANION_INACTIVITY`: A companion device was inactive for approximately 30 days. - `PRIMARY_INACTIVITY`: A primary device was inactive for approximately 30 days. - `USER_RE_REGISTERED`: WhatsApp was re-registered on a new device. Unknown values are returned as received. - `removedInitiatedBy` string — Raw initiator from the WhatsApp Business Account deletion event. Known values include: - `USER`: The removal was initiated by the WhatsApp user. - `SYSTEM`: The removal was initiated by the Meta system. Unknown values are returned as received. - `removedTime` string, date-time — The time when the WhatsApp Business Account deletion event was received, formatted in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). e.g., `2026-05-19T12:00:00.000Z`. ## Other responses - `404` — The requested resource does not exist. --- [API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)