***

title: Number Groups
slug: /reference/python/rest/number-groups
description: Manage number groups and membership.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[restclient]: /docs/server-sdks/reference/python/rest/client

[list]: /docs/server-sdks/reference/python/rest/number-groups/list

[create]: /docs/server-sdks/reference/python/rest/number-groups/create

[get]: /docs/server-sdks/reference/python/rest/number-groups/get

[update]: /docs/server-sdks/reference/python/rest/number-groups/update

[delete]: /docs/server-sdks/reference/python/rest/number-groups/delete

[listmemberships]: /docs/server-sdks/reference/python/rest/number-groups/list-memberships

[addmembership]: /docs/server-sdks/reference/python/rest/number-groups/add-membership

[getmembership]: /docs/server-sdks/reference/python/rest/number-groups/get-membership

[deletemembership]: /docs/server-sdks/reference/python/rest/number-groups/delete-membership

Manage number groups and their memberships. Number groups let you organize phone
numbers into logical collections for routing, billing, or management purposes.
This resource provides full CRUD on groups (with PUT for updates) plus membership
operations for adding and removing numbers.

Access via `client.number_groups` on a [`RestClient`][restclient] instance.

```python {9}
from signalwire.rest import RestClient

client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)

groups = client.number_groups.list()
for group in groups.get("data", []):
    print(group["id"], group.get("name"))
```

## **Methods**

<CardGroup cols={3}>
  <Card title="list" href="/docs/server-sdks/reference/python/rest/number-groups/list">
    List number groups in the project.
  </Card>

  <Card title="create" href="/docs/server-sdks/reference/python/rest/number-groups/create">
    Create a new number group.
  </Card>

  <Card title="get" href="/docs/server-sdks/reference/python/rest/number-groups/get">
    Retrieve a specific number group.
  </Card>

  <Card title="update" href="/docs/server-sdks/reference/python/rest/number-groups/update">
    Update a number group.
  </Card>

  <Card title="delete" href="/docs/server-sdks/reference/python/rest/number-groups/delete">
    Delete a number group.
  </Card>

  <Card title="list_memberships" href="/docs/server-sdks/reference/python/rest/number-groups/list-memberships">
    List phone numbers that belong to a group.
  </Card>

  <Card title="add_membership" href="/docs/server-sdks/reference/python/rest/number-groups/add-membership">
    Add a phone number to a group.
  </Card>

  <Card title="get_membership" href="/docs/server-sdks/reference/python/rest/number-groups/get-membership">
    Retrieve a specific membership.
  </Card>

  <Card title="delete_membership" href="/docs/server-sdks/reference/python/rest/number-groups/delete-membership">
    Remove a phone number from a group.
  </Card>
</CardGroup>