getMembership

Retrieve a specific membership.

This method uses the top-level membership endpoint and takes a membership ID directly, not a group ID.

Path parameters

idstringRequiredformat: "uuid"

Unique ID of the number group membership.

Response

idstringRequiredformat: "uuid"

The unique identifier of the Number Group Membership on SignalWire. This can be used to delete the membership programmatically.

number_group_idstringRequiredformat: "uuid"

The unique identifier of the Number Group this membership is associated with.

phone_numberobjectRequired

A representation of the phone number this membership is associated with.

created_atstringRequired

The date and time when the membership was created.

updated_atstringRequired

The date and time when the membership was last updated.

Response Example

Response

1 {
2   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3   "number_group_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4   "phone_number": {
5     "id": "string",
6     "name": "Jenny",
7     "number": "+15558675309",
8     "capabilities": [
9       "voice",
10       "sms",
11       "mms",
12       "fax"
13     ]
14   },
15   "created_at": "2023-01-15T10:30:00Z",
16   "updated_at": "2023-01-15T10:30:00Z"
17 }

Example

1 import { RestClient } from "@signalwire/sdk";
2 
3 const client = new RestClient({
4   project: "your-project-id",
5   token: "your-api-token",
6   host: "your-space.signalwire.com"
7 });
8 
9 const membership = await client.numberGroups.getMembership("membership-id");
10 console.log(membership["phone_number_id"]);

1	{
2	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3	"number_group_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4	"phone_number": {
5	"id": "string",
6	"name": "Jenny",
7	"number": "+15558675309",
8	"capabilities": [
9	"voice",
10	"sms",
11	"mms",
12	"fax"
13	]
14	},
15	"created_at": "2023-01-15T10:30:00Z",
16	"updated_at": "2023-01-15T10:30:00Z"
17	}

1	import { RestClient } from "@signalwire/sdk";
2
3	const client = new RestClient({
4	project: "your-project-id",
5	token: "your-api-token",
6	host: "your-space.signalwire.com"
7	});
8
9	const membership = await client.numberGroups.getMembership("membership-id");
10	console.log(membership["phone_number_id"]);