---
title: "Gets a list of conversation accounts"
method: GET
path: "/conversation_accounts"
tags: ["Conversation"]
---

# Gets a list of conversation accounts

`GET /conversation_accounts`

Fetches a paginated list of conversation accounts.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of conversation accounts.

- object
  - `next_page_token` string — Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` ConversationManagerAccount[]
    - `id` string, uuid — The unique identifier of the conversation account.
    - `customer_id` string, uuid — The unique identifier of the customer. Returned from the `GET /customers` response.
    - `type` 'line' | 'sms' | 'whatsapp' — Type of the account.
    - `name` string — Name of the account.
    - `detail` string — Detailed information about the account.
    - `secret` string — Webhook secret for signature verification. Write-only.
    - `token` string — API token for the messaging platform. Write-only.
    - `provider_data` ConversationManagerAccountProviderData — Platform-specific provider configuration. Write-only — never returned in GET responses or webhook payloads. Currently used for WhatsApp accounts only.
      - `phone_number_id` string — The Meta phone number ID associated with your WhatsApp Business phone number. Found in Meta Business Manager under WhatsApp → Phone numbers.
      - `app_secret` string — The Meta app secret for your WhatsApp Business App. Used to validate the X-Hub-Signature-256 header on inbound webhook requests from Meta.
    - `message_flow_id` string, uuid — The flow ID to execute when a message is received on this account. Returned from the `GET /flows` response.
    - `tm_create` string, date-time — Timestamp when the account was created.
    - `tm_update` string, date-time — Timestamp when the account was last updated.
    - `tm_delete` string, date-time — Timestamp when the account was deleted.

## Other responses

- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/revisions/48dafc7da0a6/schema)