---
title: "List all senders in project"
method: GET
path: "/v1/projects/{projectId}/kakaotalk/senders"
tags: ["KakaoTalk Senders"]
---

# List all senders in project

`GET /v1/projects/{projectId}/kakaotalk/senders`

Returns a paginated list of senders for the specified project. If no page token is supplied then the first `50` will be returned.

## Path parameters

- `projectId` string, required

## Query parameters

- `pageToken` string
- `pageSize` number
- `filterStates` string[]
- `filterStatuses` string[]

## Response `200`

List of senders

- KakaotalkSenderListDto
  - `totalSize` number, required — Total size of the entries matching the search query.
  - `pageSize` number, required — Requested size of the page.
  - `previousPageToken` string — Encoded token to use in list request to fetch previous batch of entries.
  - `nextPageToken` string — Encoded token to use in list request to fetch next batch of entries.
  - `senders` KakaotalkSenderDto[], required — List of senders.
    - `id` string — The unique ID of the sender.
    - `plusFriendId` string, required — PlusFriend ID
    - `state` 'ACTIVE' | 'BLOCKED' | 'INACTIVE' | 'SUSPENDED' | 'VERIFYING' — The current state of the sender.
    - `changes` KakaotalkSenderChangesDto
      - `status` 'DRAFT' | 'IN_PROGRESS' | 'REJECTED', required — Current status of the pending changes.
      - `details` union, required — Sender details and information.
        - object
          - `adminPhoneNo` string, required — Admin phone
          - `name` string, required — Sender name
          - `logoImage` string — Sender logo
          - `topLevelCategoryCode` string, required — Top level category code, must consist of 3 digits (e.g. 001).
          - `midLevelCategoryCode` string, required — Mid level category code, must consist of 4 digits (e.g. 0001).
          - `subLevelCategoryCode` string, required — Sub level category code, must consist of 4 digits (e.g. 0001).
        - object
          - `adminPhoneNo` string — Admin phone
          - `name` string — Sender name
          - `logoImage` string — Sender logo
          - `topLevelCategoryCode` string — Top level category code, must consist of 3 digits (e.g. 001).
          - `midLevelCategoryCode` string — Mid level category code, must consist of 4 digits (e.g. 0001).
          - `subLevelCategoryCode` string — Sub level category code, must consist of 4 digits (e.g. 0001).
    - `details` KakaotalkSenderDetailsDto
      - `adminPhoneNo` string, required — Admin phone
      - `name` string, required — Sender name
      - `logoImage` string — Sender logo
      - `topLevelCategoryCode` string, required — Top level category code, must consist of 3 digits (e.g. 001).
      - `midLevelCategoryCode` string, required — Mid level category code, must consist of 4 digits (e.g. 0001).
      - `subLevelCategoryCode` string, required — Sub level category code, must consist of 4 digits (e.g. 0001).
    - `created` string — The UTC Date Time in ISO 8601 for when the sender was created.
    - `modified` string — The UTC Date Time in ISO 8601 for when the sender was last modified.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound
- `500` — InternalServerError

---

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