---
title: "Get the list of predefined item groups (for the logged API user's account)"
description: "GET /predefined_item_groups — Returns the account's predefined item groups. A group bundles predefined items under one name, and its cost and price are the sums of its members. Pass include_items to embed the items themselves."
canonical_url: https://developer.onepagecrm.com/api/reference/predefined-item-groups/get-predefined_item_groups/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/predefined-item-groups/get-predefined_item_groups/
---

`GET /predefined_item_groups`

Returns the account's predefined item groups. A group bundles predefined items under one name, and its cost and price are the sums of its members. Pass include_items to embed the items themselves.

Resource: [Predefined Item Groups](https://developer.onepagecrm.com/api/reference/predefined-item-groups/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl "https://app.onepagecrm.com/api/v3/predefined_item_groups" \
  -u $user_id:$api_key
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "predefined_item_groups": [
      {
        "predefined_item_group": {
          "id": "5c79510e9007ba3f7519e819",
          "name": "Electronics",
          "position": 1,
          "count": 2,
          "item_ids": [
            "5c79510e9007ba3f7519e819",
            "5c9a53349007ba58f13c8118"
          ]
        }
      }
    ]
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)