Skip to main content
GET
List sender IDs
Required scope: PARTNER
Lists the sender IDs declared on one of your accounts, with the review status of each one. An account holds at most 3 sender IDs.
  • page starts at 1 and size defaults to 20, up to 100. The response carries the usual pagination object, see Pagination.
  • status is PENDING, VALIDATED, FAILED or DISABLED. See Get sender ID for what each one means.
  • An account your API key did not create returns 404 PARTNER_ACCOUNT_NOT_FOUND.
To declare a sender ID, call Declare sender ID.

Authorizations

Authorization
string
header
required

Path Parameters

account_id
string
required

The account id returned by Create account (usr-*).

Query Parameters

page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
size
integer
default:20

Results per page

Required range: 1 <= x <= 100

Response

The account's sender IDs

data
object[]
pagination
object