---
title: "Get designation groups"
method: GET
path: "/v1/designation_groups"
tags: ["Designation groups"]
---

# Get designation groups

`GET /v1/designation_groups`

Use this request to retrieve a paginated list of designation groups from your Fundraise Up account. A designation group is a container for related designations and other designation groups.

## Query parameters

- `livemode` boolean
- `starting_after` string
- `ending_before` string
- `limit` integer
- `created` CreatedQuery — Filters results by the record creation date. Accepts a single date or a date range in RFC 3339 format.
  - `created[gt]` string, date-time — Minimum creation date (exclusive). Returns records after this timestamp.
  - `created[gte]` string, date-time — Minimum creation date (inclusive). Returns records from and after this timestamp.
  - `created[lt]` string, date-time — Maximum creation date (exclusive). Returns records before this timestamp.
  - `created[lte]` string, date-time — Maximum creation date (inclusive). Returns records up to and including this timestamp.
- `designation` string

## Response `200`

On success, the API returns a list of designation groups. The response includes an array of designation group objects and a boolean indicating whether more records are available.

- DesignationGroupsResponse — Provides a paginated response for designation groups.
  - `data` DesignationGroupResponse[], required — An array containing the designation group records, paginated by any request parameters.
    - `children` union[], required — Designations or nested designation groups.
      - union
        - ChildDesignation — A designation that belongs to a designation group.
          - `code` string, nullable, required — Designation code.
          - `id` string, required — Unique designation identifier.
          - `name` string, required — Designation name.
          - `type` 'designation', required — Item type discriminator. Always `designation`.
        - ChildGroup — A designation group nested inside another designation group.
          - `children` union[], required — Child items: designations or nested designation groups (up to 3 levels deep).
            - union
              - …
          - `id` string, required — Unique designation group identifier.
          - `name` string, required — Designation group name.
          - `type` 'designation_group', required — Item type discriminator. Always `designation_group`.
    - `id` string, required — Unique identifier of the designation group.
    - `name` string, required — Designation group name.
  - `has_more` boolean, required — Indicates whether there are more records available. For `starting_after`, it shows that there is a page with older records. For `ending_before`, it indicates that there is a page with newer records.

## Other responses

- `403` — Forbidden. The API key does not have permission to access designation groups.

---

[API](https://skmtc.net/fundraiseup/apis/fundraise-up-api.md) · [All operations](https://skmtc.net/fundraiseup/apis/fundraise-up-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fundraiseup/fundraise-up-api/revisions/f59881dadecd/schema)