get_membership | 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 from signalwire.rest import RestClient
2 
3 client = RestClient(
4     project="your-project-id",
5     token="your-api-token",
6     host="your-space.signalwire.com",
7 )
8 
9 membership = client.number_groups.get_membership("membership-id")
10 print(membership.get("phone_number_id"))