---
title: "Get RCS test numbers"
method: GET
path: "/rcs/1/senders/{senderName}/test-numbers"
tags: ["channels", "rcs", "rcs-service-management", "rcs-test-number-management"]
---

# Get RCS test numbers

`GET /rcs/1/senders/{senderName}/test-numbers`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/rcs/1/senders/{senderName}/test-numbers`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Get RCS test numbers for given sender. Please note that information about status of test number was correct at the moment when test number was last time updated. If latest status for some test number is needed, [Get RCS test number](#channels/rcs/get-rcs-test-number) operation can be used.

## Path parameters

- `senderName` string, required

## Query parameters

- `page` integer
- `size` integer
- `sort` string

## Response `200`

List of RCS test numbers

- C4d4776b979fea48176211c392051aca0dae21d75b7a9ca349c8f2eb95a84913RcsTestNumberPageResponse
  - `results` C4d4776b979fea48176211c392051aca0dae21d75b7a9ca349c8f2eb95a84913RcsTestNumber[], required: The list of the results for this page.
    - `testNumber` string, required: Full number in E.164 format, e.g. +1234567890. Leading '+' is optional.
    - `status` 'PENDING' | 'WAITING_FOR_TESTER_ACCEPTANCE' | 'APPROVED' | 'EXPIRED' | 'UNSUPPORTED' | 'FAILED', required: Status of the test number. It'll be updated by Infobip platform automatically and notification about test number status update will be sent to client's webhook. Following statuses are available: * `PENDING`: Test device registration is pending until 3rd party action will be executed. * `WAITING_FOR_TESTER_ACCEPTANCE`: Waiting for user to accept request to become a tester. * `APPROVED`: User has accepted to become a tester and test messages can be sent to that number. * `EXPIRED`: If user does not accept invitation within 24h, status of test number will be moved to EXPIRED. * `UNSUPPORTED`: Test number is not supported for RCS traffic. * `FAILED`: Failed mostly because of some internal service error during request processing. Please contact support.
    - `updatedAt` string, date-time, required: Timestamp when test number has been updated last time.
    - `primary` boolean, required: Set this test number as primary for this sender. A test number can only be primary for one sender, although a sender may have multiple numbers marked as primary; selecting it here will remove the primary flag from any sender where it is already marked as such. Relevant when multiple senders share the same Application and Entity via Resource Association.
  - `paging` C4d4776b979fea48176211c392051aca0dae21d75b7a9ca349c8f2eb95a84913PageInfo, required: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)