# Get Capacity Pool

Returns a single Capacity Pool.

## Request

HTTP Method: `GET`

URI Path: `/v3/capacity_pools/{id}`

Note

For all returned data attributes, see [Capacity Pool Object](capacity-pool-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique ID number allocated to this Capacity Pool. |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes). |

### Includes

| Value | Description |
| --- | --- |
| countries | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v35) |
| shared\_capacity\_groups | [Shared Capacity Group Object](../shared-capacity-group/shared-capacity-group-object.html#shared-capacity-group-object-v35) |
| qty\_based\_pricings | [Quantity Based Price Object](../../common-definitions/index.html#quantity-based-price-object-v35) |

## Examples

Simple RequestInclude CountriesInclude Shared Capacity Groups

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "b8db1d7c-f415-4530-a340-c774bcc1c55f",
 7    "type": "capacity_pools",
 8    "attributes": {
 9      "name": "Extended",
10      "renew_date": "2018-07-21",
11      "total_channels_count": 10,
12      "assigned_channels_count": 6,
13      "minimum_limit": 5,
14      "minimum_qty_per_order": 1,
15      "setup_price": "25.0",
16      "monthly_price": "25.0",
17      "metered_rate": "0.02"
18    },
19    "relationships": {
20      "countries": {
21        "links": {
22          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/countries",
23          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/countries"
24        }
25      },
26      "shared_capacity_groups": {
27        "links": {
28          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/shared_capacity_groups",
29          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/shared_capacity_groups"
30        }
31      },
32      "qty_based_pricings": {
33        "links": {
34          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/qty_based_pricings",
35          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/qty_based_pricings"
36        }
37      }
38    }
39  },
40  "meta": {
41    "api_version": "2026-11-19"
42  }
43}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f?include=countries HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f?include=countries' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "b8db1d7c-f415-4530-a340-c774bcc1c55f",
 7    "type": "capacity_pools",
 8    "attributes": {
 9      "name": "Extended",
10      "renew_date": "2018-07-21",
11      "total_channels_count": 10,
12      "assigned_channels_count": 6,
13      "minimum_limit": 5,
14      "minimum_qty_per_order": 1,
15      "setup_price": "25.0",
16      "monthly_price": "25.0",
17      "metered_rate": "0.02"
18    },
19    "relationships": {
20      "countries": {
21        "links": {
22          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/countries",
23          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/countries"
24        },
25        "data": [
26          {
27            "type": "countries",
28            "id": "7eda11bb-0e66-4146-98e7-57a5281f56c8"
29          },
30          {
31            "type": "countries",
32            "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
33          }
34        ]
35      },
36      "shared_capacity_groups": {
37        "links": {
38          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/shared_capacity_groups",
39          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/shared_capacity_groups"
40        }
41      },
42      "qty_based_pricings": {
43        "links": {
44          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/qty_based_pricings",
45          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/qty_based_pricings"
46        }
47      }
48    }
49  },
50  "included": [
51    {
52      "id": "7eda11bb-0e66-4146-98e7-57a5281f56c8",
53      "type": "countries",
54      "attributes": {
55        "name": "United Kingdom",
56        "prefix": "44",
57        "iso": "GB"
58      },
59      "relationships": {
60        "regions": {
61          "links": {
62            "self": "https://api.didww.com/v3/countries/7eda11bb-0e66-4146-98e7-57a5281f56c8/relationships/regions",
63            "related": "https://api.didww.com/v3/countries/7eda11bb-0e66-4146-98e7-57a5281f56c8/regions"
64          }
65        }
66      }
67    },
68    {
69      "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9",
70      "type": "countries",
71      "attributes": {
72        "name": "United States",
73        "prefix": "1",
74        "iso": "US"
75      },
76      "relationships": {
77        "regions": {
78          "links": {
79            "self": "https://api.didww.com/v3/countries/1f6fc2bd-f081-4202-9b1a-d9cb88d942b9/relationships/regions",
80            "related": "https://api.didww.com/v3/countries/1f6fc2bd-f081-4202-9b1a-d9cb88d942b9/regions"
81          }
82        }
83      }
84    }
85  ],
86  "meta": {
87    "api_version": "2026-11-19"
88  }
89}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f?include=shared_capacity_groups HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f?include=shared_capacity_groups' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "b8db1d7c-f415-4530-a340-c774bcc1c55f",
 7    "type": "capacity_pools",
 8    "attributes": {
 9      "name": "Extended",
10      "renew_date": "2018-07-21",
11      "total_channels_count": 10,
12      "assigned_channels_count": 6,
13      "minimum_limit": 5,
14      "minimum_qty_per_order": 1,
15      "setup_price": "25.0",
16      "monthly_price": "25.0",
17      "metered_rate": "0.02"
18    },
19    "relationships": {
20      "countries": {
21        "links": {
22          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/countries",
23          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/countries"
24        }
25      },
26      "shared_capacity_groups": {
27        "links": {
28          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/shared_capacity_groups",
29          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/shared_capacity_groups"
30        },
31        "data": [
32          {
33            "type": "shared_capacity_groups",
34            "id": "dd2e8844-6a79-4673-ba1c-c8a4913884cc"
35          }
36        ]
37      },
38      "qty_based_pricings": {
39        "links": {
40          "self": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/relationships/qty_based_pricings",
41          "related": "https://api.didww.com/v3/capacity_pools/b8db1d7c-f415-4530-a340-c774bcc1c55f/qty_based_pricings"
42        }
43      }
44    }
45  },
46  "included": [
47    {
48      "id": "dd2e8844-6a79-4673-ba1c-c8a4913884cc",
49      "type": "shared_capacity_groups",
50      "attributes": {
51        "name": "Sample group",
52        "shared_channels_count": 0,
53        "created_at": "2018-06-19T11:41:21.644Z",
54        "external_reference_id": null,
55        "metered_channels_count": 30
56      },
57      "relationships": {
58        "capacity_pool": {
59          "links": {
60            "self": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/relationships/capacity_pool",
61            "related": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/capacity_pool"
62          }
63        },
64        "dids": {
65          "links": {
66            "self": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/relationships/dids",
67            "related": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/dids"
68          }
69        }
70      }
71    }
72  ],
73  "meta": {
74    "api_version": "2026-11-19"
75  }
76}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 429 | No | The request budget of the account for the current window is spent (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
