---
title: "Get all your approved Sender IDs"
method: GET
path: "/api/v2/senderids"
tags: ["Sender IDs"]
---

# Get all your approved Sender IDs

`GET /api/v2/senderids`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Sender%20IDs/getSenderIds" target="_blank">Try in sandbox</a><br>

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Sender IDs of the current user returned with success.

- GetSenderIdsPaginatedResponse
  - `page` integer, required
  - `pageCount` integer, required — The total number of pages.
  - `limit` integer, required — The number of results per page.
  - `resources` SenderId[], required
    - `id` integer, required — Numeric sender ID.
    - `displayTimeFormat` string — Format for representation of time.
    - `senderId` string, required — Alphanumeric ID.
    - `user` User, nullable, required
      - `id` integer, required — User ID.
      - `displayTimeFormat` '12h' | '24h' — User's preferred format of time display: * *12h* - AM/PM format; * *24h* - 24-hour clock format.
      - `username` string, required — Username.
      - `firstName` string, required — Account first name.
      - `lastName` string, required — Account last name.
      - `email` string, required — User email address.
      - `status` 'A' | 'T', required — Current account status: * **A** for Active; * **T** for Trial.
      - `balance` number, required — Account balance (in account currency).
      - `phone` string, nullable, required — User's phone number.
      - `company` string, nullable, required — Account company name.
      - `currency` Currency, required
        - `id` string, required — The 3-letter ISO currency ID.
        - `unicodeSymbol` string, required — Unicode-compatible currency symbol.
        - `htmlSymbol` string, required — HTML-compatible currency symbol.
      - `country` Country, nullable, required
        - `id` string, required — The 2-letter ISO country ID.
        - `name` string, required — Full country name.
      - `timezone` Timezone, required
        - `id` integer, required — Internal timezone ID.
        - `area` string, required — Timezone area.
        - `dst` integer, required — Is daylight saving time used in this timezone?
        - `offset` integer, required — Offset from UTC time in seconds. In this example, it is 21600/60/60=6 hours.
        - `timezone` string, required — User-friendly timezone name (with spaces replaced by underscores).
      - `subaccountType` 'P' | 'A' | 'U', required — Type of account: * **P** for Parent User; * **A** for Administrator Sub-Account; * **U** for Regular User.
      - `emailAccepted` boolean, required — Does the account have a confirmed email?
      - `phoneAccepted` boolean, required — Does the account have a confirmed phone number?
      - `avatar` UserImage, nullable, required
        - `href` string, required — The URI of a user avatar.
    - `status` 'A' | 'R' | 'P', required — * **P** for Pending - this Sender ID is being reviewed by our support team; * **R** for Rejected - our support team rejected your application for this Sender ID; * **A** for Active.

## Other responses

- `401` — Unauthorized request.

---

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