---
search:
  tags:
    - Subscriptions
    - GET
seo:
  description: >-
    Returns the additional customers sharing a membership subscription,…
    Reference for the GET /subscription_purchases/{id}/seats endpoint in the
    Bolder API v2.
sidebar:
  label: List membership seats
  badge: GET
title: List membership seats
type: openapi-operation
---
Returns the additional customers sharing a membership subscription, with the purchase's `max_seats`. The purchasing customer is not listed: they occupy one seat implicitly. Rel: `subscriptions:seats`.

`GET /subscription_purchases/{id}/seats`

**Responses**

- `200` — Membership seats
- `403` — Token lacks \`orders.read\` on the purchase's account
- `404` — Not found, or the purchase is not of a membership plan

Response example, 200:

```json
{
  "_links": {
    "property1": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    },
    "property2": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    }
  },
  "total_items": 0,
  "max_seats": 0,
  "_embedded": {
    "items": [
      {
        "_links": {
          "property1": {
            "href": "string",
            "templated": true,
            "method": "get",
            "title": "string",
            "type": "string"
          },
          "property2": {
            "href": "string",
            "templated": true,
            "method": "get",
            "title": "string",
            "type": "string"
          }
        },
        "id": 0,
        "subscription_purchase_id": 0,
        "contact_id": 0,
        "contact_email": "string",
        "contact_name": "string",
        "created_on": "2019-08-24"
      }
    ]
  }
}
```