---
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`

## Request

- Base URL: `https://provisioning.api.sinch.com`
- URL: `https://provisioning.api.sinch.com/v1/projects/{projectId}/kakaotalk/senders`
- Auth: HTTP basic and HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `https://auth.sinch.com/oauth2/token`

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` KakaotalkSenderStatesEnum[]
- `filterStatuses` KakaotalkSenderStatusesEnum[]

## 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

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-09-01** `c6a937922d10`: 6 breaking, 27 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `500`
  - …29 more

[Operation history](https://skmtc.dev/sinch/apis/provisioning-api/changes/v1/projects/:projectId/kakaotalk/senders/get.md)

---

[API](https://skmtc.dev/sinch/apis/provisioning-api.md) - [All operations](https://skmtc.dev/sinch/apis/provisioning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/provisioning-api/revisions/90d78b3a8575?raw)