getMembership | SignalWire

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"]);