---
title: "Get the current list of all available capacity provider account groups."
method: GET
path: "/api/v4/capacityprovideraccountgroups"
tags: ["Capacity Provider Account Group Management"]
---

# Get the current list of all available capacity provider account groups.

`GET /api/v4/capacityprovideraccountgroups`

## Request

- Base URL: `https://na12.api.project44.com`
- URL: `https://na12.api.project44.com/api/v4/capacityprovideraccountgroups`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v4/oauth2/token`
- TypeScript: <https://skmtc.dev/project44/apis/project44-rest-api/docs/api/v4/capacityprovideraccountgroups/get.ts> (a function with typed inputs; its response is checked against the schema)

Each capacity provider account group returned in the response includes a unique id that can be used as reference in other APIs.

## Response `200`

OK

- CapacityProviderAccountGroupInfoCollection: A collection of details necessary to get or instantiate a new capacity provider group.
  - `groups` CapacityProviderAccountGroupInfo[]: List of multiple capacity provider account groups.
    - `code` string: The unique, user-provided code used to identify this account group. Typically, an account group will correspond to a single customer or a single customer location. Account group codes are provided in shipment lifecycle APIs to identify a particular account. This field may be provided when creating an account group but is not required when creating or updating a set of capacity provider accounts in the capacity provider account management API.
    - `id` integer: The project44-generated id of the capacity provider account group. This id may not be provided when creating a capacity provider account group, but it is required when updating one or when creating or updating a capacity provider account set.
    - `name` string: The user-provided name to be assigned to this group. This field may be provided when creating an account group but is not required when creating or updating a set of capacity provider accounts in the capacity provider account management API.

## Other responses

- `400`: Invalid request
- `401`: Invalid or missing credentials
- `403`: User not authorized to perform this operation

---

[API](https://skmtc.dev/project44/apis/project44-rest-api.md) - [All operations](https://skmtc.dev/project44/apis/project44-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/project44/apis/project44-rest-api/revisions/cdf9675e2294?raw)