List RCS senders
Returns the RCS senders on your account as a bare JSON array, without a total count. Page through them with limit and offset; an empty array means you have reached the end.
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/senders \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.rcs_senders.list_senders()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/senders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": "7a1c3e5f-9b2d-4c6e-8f0a-1b3d5e7f9a21",
"accountId": "MA_XXXXXXXX",
"provider": "YOUR_ROUTING_IDENTIFIER",
"senderName": "example-brand",
"displayName": "Example Brand",
"description": "Order updates and support for Example Brand customers.",
"billingCategory": "CONVERSATIONAL",
"useCase": "TRANSACTIONAL",
"hostingRegion": "NORTH_AMERICA",
"status": "pending",
"brand": {
"brandName": "Example Brand"
},
"color": "#1A73E8",
"createdAt": "2026-10-12T10:30:00Z",
"updatedAt": "2026-10-12T10:30:00Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Query Parameters
Maximum number of items to return, from 1 to 100. Defaults to 20; a value outside that range or a non-integer is replaced by the default.
1 <= x <= 100Number of items to skip before the page starts. Defaults to 0. Pass a whole number of 0 or more.
x >= 0Response
An array of senders. Empty when you have none.
Unique identifier of the sender on Vobiz (UUID). Use it in every /senders/{id} path.
"7a1c3e5f-9b2d-4c6e-8f0a-1b3d5e7f9a21"
Your Vobiz account ID (MA_...) that owns the sender.
"MA_XXXXXXXX"
Internal routing identifier; do not rely on its value.
"YOUR_ROUTING_IDENTIFIER"
Unique technical name of the sender on the RCS platform. Pass it as from when you send RCS. Fixed after creation.
"example-brand"
The brand name recipients see at the top of the conversation.
"Example Brand"
Short description shown on the sender's info page.
"Order updates and support for Example Brand customers."
How the RCS platform bills conversations from this sender, for example CONVERSATIONAL or NON_CONVERSATIONAL.
"CONVERSATIONAL"
The kind of traffic the sender carries, for example OTP, TRANSACTIONAL, PROMOTIONAL or MULTI_USE.
"TRANSACTIONAL"
The region where the RCS platform hosts the sender, for example NORTH_AMERICA, EUROPE or ASIA_PACIFIC. Fixed after creation.
"NORTH_AMERICA"
Launch status reported by the RCS platform, stored on your account. pending until the platform reports otherwise. Call GET /senders/{id}/status to refresh it.
"pending"
The brand the sender represents. Omitted when not set.
Show child attributes
Show child attributes
Accent colour as a hex code. Omitted when not set.
"#1A73E8"
Contact phone numbers shown on the sender's info page. Omitted when none are set.
Show child attributes
Show child attributes
Contact email addresses shown on the sender's info page. Omitted when none are set.
Show child attributes
Show child attributes
Websites shown on the sender's info page. Omitted when none are set.
Show child attributes
Show child attributes
HTTPS URL of the banner image. Omitted when not set.
"https://example.com/rcs/banner.jpg"
HTTPS URL of the logo image. Omitted when not set.
"https://example.com/rcs/logo.png"
Link to your privacy policy.
Show child attributes
Show child attributes
Link to your terms of service.
Show child attributes
Show child attributes
Identifiers the RCS platform assigned to your agent. Omitted when not set.
Show child attributes
Show child attributes
When the sender was created on your account (ISO 8601, UTC).
"2026-10-12T10:30:00Z"
When the sender last changed, including status refreshes (ISO 8601, UTC).
"2026-10-12T10:30:00Z"
Was this page helpful?
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/senders \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.rcs_senders.list_senders()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/senders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": "7a1c3e5f-9b2d-4c6e-8f0a-1b3d5e7f9a21",
"accountId": "MA_XXXXXXXX",
"provider": "YOUR_ROUTING_IDENTIFIER",
"senderName": "example-brand",
"displayName": "Example Brand",
"description": "Order updates and support for Example Brand customers.",
"billingCategory": "CONVERSATIONAL",
"useCase": "TRANSACTIONAL",
"hostingRegion": "NORTH_AMERICA",
"status": "pending",
"brand": {
"brandName": "Example Brand"
},
"color": "#1A73E8",
"createdAt": "2026-10-12T10:30:00Z",
"updatedAt": "2026-10-12T10:30:00Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}