---
title: "GET /v1/whatsapp/waba/list"
method: GET
path: "/v1/whatsapp/waba/list"
---

# GET /v1/whatsapp/waba/list

`GET /v1/whatsapp/waba/list`

List all WhatsApp Business Accounts linked to your Amazon Web Services account.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListLinkedWhatsAppBusinessAccountsOutput
  - `linkedAccounts` LinkedWhatsAppBusinessAccountSummary[] — A list of WhatsApp Business Accounts linked to your Amazon Web Services account.
    - `arn` string, required — The ARN of the linked WhatsApp Business Account.
    - `id` string, required — The ID of the linked WhatsApp Business Account, formatted as <code>waba-01234567890123456789012345678901</code>.
    - `wabaId` string, required — The WhatsApp Business Account ID provided by Meta.
    - `registrationStatus` 'COMPLETE' | 'INCOMPLETE', required — The registration status of the linked WhatsApp Business Account.
    - `linkDate` string, date-time, required — The date the WhatsApp Business Account was linked.
    - `wabaName` string, required — The name of the linked WhatsApp Business Account.
    - `eventDestinations` WhatsAppBusinessAccountEventDestination[], required — The event destinations for the linked WhatsApp Business Account.
      - `eventDestinationArn` string, required — The ARN of the event destination.
      - `roleArn` string — The Amazon Resource Name (ARN) of an Identity and Access Management role that is able to import phone numbers and write events.
    - `marketingMessagesOnboardingStatus` string — The onboarding status for the Marketing Messages API. This value is fetched from Meta and indicates whether the WhatsApp Business Account is onboarded for Meta's Marketing Messages API.
  - `nextToken` string — The next token for pagination.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InvalidParametersException
- `483` — ResourceNotFoundException
- `484` — ThrottledRequestException
- `485` — InternalServiceException

---

[API](https://skmtc.net/aws/apis/socialmessaging.md) · [All operations](https://skmtc.net/aws/apis/socialmessaging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/socialmessaging/versions/127e73cd9a15/schema)