get_membership

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

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