# Get Capacity Pools

Returns a list of Capacity Pools.

## Request

HTTP Method: `GET`

URI Path: `/v3/capacity_pools`

Note

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

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| filter[<filter\_name>] | `string` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[capacity\_pools] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../../specification/sorting.html#api-sorting) |

### Includes

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

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | Capacity Pool `id` field. |
| name | `string` | No | Yes | Capacity Pool `name` field. |
| country.id | `string` | No | Yes | The `id` field of the Capacity Pool's `countries` relationship. |
| has\_unassigned\_channels | `boolean` | No | No | Indicates whether the Capacity Pool has unassigned channels available. |

### Sorting

| Value | Sorts by |
| --- | --- |
| name | The `name` field. |
| renew\_date | The `renew_date` field. |
| total\_channels\_count | The `total_channels_count` field. |
| assigned\_channels\_count | The `assigned_channels_count` field. |
| minimum\_limit | The `minimum_limit` field. |
| minimum\_qty\_per\_order | The `minimum_qty_per_order` field. |
| setup\_price | The `setup_price` field. |
| monthly\_price | The `monthly_price` field. |
| metered\_rate | The `metered_rate` field. |

## Examples

Simple RequestInclude CountriesInclude Shared Capacity Groups

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/capacity_pools HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET https://api.didww.com/v3/capacity_pools -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "ca1315c5-1915-4fc7-9441-de78e1f38ef9",
      "type": "capacity_pools",
      "attributes": {
        "name": "Extended",
        "renew_date": "2018-07-21",
        "total_channels_count": 136,
        "assigned_channels_count": 136,
        "minimum_limit": 0,
        "minimum_qty_per_order": 1,
        "setup_price": "25.0",
        "monthly_price": "25.0",
        "metered_rate": "0.02"
      },
      "relationships": {
        "countries": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/countries",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/countries"
          }
        },
        "shared_capacity_groups": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/shared_capacity_groups",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/shared_capacity_groups"
          }
        },
        "qty_based_pricings": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/qty_based_pricings",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/qty_based_pricings"
          }
        }
      }
    },
    {
      "id": "daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d",
      "type": "capacity_pools",
      "attributes": {
        "name": "Standard",
        "renew_date": "2018-07-21",
        "total_channels_count": 2,
        "assigned_channels_count": 2,
        "minimum_limit": 0,
        "minimum_qty_per_order": 1,
        "setup_price": "15.0",
        "monthly_price": "15.0",
        "metered_rate": "0.01"
      },
      "relationships": {
        "countries": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/countries",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/countries"
          }
        },
        "shared_capacity_groups": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/shared_capacity_groups",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/shared_capacity_groups"
          }
        },
        "qty_based_pricings": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/qty_based_pricings",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/qty_based_pricings"
          }
        }
      }
    }
  ],
  "meta": {
    "total_records": 2
  },
  "links": {
    "first": "https://api.didww.com/v3/capacity_pools?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/capacity_pools?page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/capacity_pools?include=countries HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET 'https://api.didww.com/v3/capacity_pools?include=countries' -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "ca1315c5-1915-4fc7-9441-de78e1f38ef9",
      "type": "capacity_pools",
      "attributes": {
        "name": "Extended",
        "renew_date": "2018-07-21",
        "total_channels_count": 136,
        "assigned_channels_count": 136,
        "minimum_limit": 0,
        "minimum_qty_per_order": 1,
        "setup_price": "25.0",
        "monthly_price": "25.0",
        "metered_rate": "0.02"
      },
      "relationships": {
        "countries": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/countries",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/countries"
          },
          "data": [
            {
              "type": "countries",
              "id": "7eda11bb-0e66-4146-98e7-57a5281f56c8"
            }
          ]
        },
        "shared_capacity_groups": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/shared_capacity_groups",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/shared_capacity_groups"
          }
        },
        "qty_based_pricings": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/qty_based_pricings",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/qty_based_pricings"
          }
        }
      }
    },
    {
      "id": "daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d",
      "type": "capacity_pools",
      "attributes": {
        "name": "Standard",
        "renew_date": "2018-07-21",
        "total_channels_count": 2,
        "assigned_channels_count": 2,
        "minimum_limit": 0,
        "minimum_qty_per_order": 1,
        "setup_price": "15.0",
        "monthly_price": "15.0",
        "metered_rate": "0.01"
      },
      "relationships": {
        "countries": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/countries",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/countries"
          },
          "data": [
            {
              "type": "countries",
              "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
            }
          ]
        },
        "shared_capacity_groups": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/shared_capacity_groups",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/shared_capacity_groups"
          }
        },
        "qty_based_pricings": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/qty_based_pricings",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/qty_based_pricings"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "7eda11bb-0e66-4146-98e7-57a5281f56c8",
      "type": "countries",
      "attributes": {
        "name": "United Kingdom",
        "prefix": "44",
        "iso": "GB"
      }
    },
    {
      "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9",
      "type": "countries",
      "attributes": {
        "name": "United States",
        "prefix": "1",
        "iso": "US"
      }
    }
  ],
  "meta": {
    "total_records": 2
  },
  "links": {
    "first": "https://api.didww.com/v3/capacity_pools?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/capacity_pools?page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/capacity_pools?include=shared_capacity_groups HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET 'https://api.didww.com/v3/capacity_pools?include=shared_capacity_groups' -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "ca1315c5-1915-4fc7-9441-de78e1f38ef9",
      "type": "capacity_pools",
      "attributes": {
        "name": "Extended",
        "renew_date": "2018-07-21",
        "total_channels_count": 136,
        "assigned_channels_count": 136,
        "minimum_limit": 0,
        "minimum_qty_per_order": 1,
        "setup_price": "25.0",
        "monthly_price": "25.0",
        "metered_rate": "0.02"
      },
      "relationships": {
        "countries": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/countries",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/countries"
          }
        },
        "shared_capacity_groups": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/shared_capacity_groups",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/shared_capacity_groups"
          },
          "data": [
            {
              "type": "shared_capacity_groups",
              "id": "dd2e8844-6a79-4673-ba1c-c8a4913884cc"
            }
          ]
        },
        "qty_based_pricings": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/relationships/qty_based_pricings",
            "related": "https://api.didww.com/v3/capacity_pools/ca1315c5-1915-4fc7-9441-de78e1f38ef9/qty_based_pricings"
          }
        }
      }
    },
    {
      "id": "daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d",
      "type": "capacity_pools",
      "attributes": {
        "name": "Standard",
        "renew_date": "2018-07-21",
        "total_channels_count": 2,
        "assigned_channels_count": 2,
        "minimum_limit": 0,
        "minimum_qty_per_order": 1,
        "setup_price": "15.0",
        "monthly_price": "15.0",
        "metered_rate": "0.01"
      },
      "relationships": {
        "countries": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/countries",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/countries"
          }
        },
        "shared_capacity_groups": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/shared_capacity_groups",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/shared_capacity_groups"
          }
        },
        "qty_based_pricings": {
          "links": {
            "self": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/relationships/qty_based_pricings",
            "related": "https://api.didww.com/v3/capacity_pools/daae37a3-c4fc-40a7-b5e6-6ec9d08ed74d/qty_based_pricings"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "dd2e8844-6a79-4673-ba1c-c8a4913884cc",
      "type": "shared_capacity_groups",
      "attributes": {
        "name": "Sample group",
        "shared_channels_count": 0,
        "created_at": "2018-06-19T11:41:21.644Z",
        "metered_channels_count": 30
      },
      "relationships": {
        "capacity_pool": {
          "links": {
            "self": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/relationships/capacity_pool",
            "related": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/capacity_pool"
          }
        },
        "dids": {
          "links": {
            "self": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/relationships/dids",
            "related": "https://api.didww.com/v3/shared_capacity_groups/dd2e8844-6a79-4673-ba1c-c8a4913884cc/dids"
          }
        }
      }
    }
  ],
  "meta": {
    "total_records": 2
  },
  "links": {
    "first": "https://api.didww.com/v3/capacity_pools?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/capacity_pools?page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page