list

View as MarkdownOpen in Claude

List number groups in the project.

Query parameters

filter_namestringOptional<=255 characters
Filter by name. Returns all number groups containing this value as a substring.
page_numberintegerOptionalDefaults to 0
The page number to retrieve.
page_sizeintegerOptional1-1000Defaults to 50
The number of results per page.
page_tokenstringOptional
Token for cursor-based pagination.

Response

datalist of objectsRequired
List of number groups.

Response Example

Response
1{
2 "links": {
3 "self": "string",
4 "first": "string",
5 "next": "string",
6 "prev": "string"
7 },
8 "data": [
9 {
10 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
11 "name": "My Number Group",
12 "sticky_sender": false,
13 "phone_number_count": 4
14 }
15 ]
16}

Example

1import { RestClient } from "@signalwire/sdk";
2
3const client = new RestClient({
4 project: "your-project-id",
5 token: "your-api-token",
6 host: "your-space.signalwire.com"
7});
8
9const result = await client.numberGroups.list();
10for (const group of result.data ?? []) {
11 console.log(group.name, group.id);
12}