---
title: "Get a designation group"
method: GET
path: "/v1/designation_groups/{id}"
tags: ["Designation groups"]
---

# Get a designation group

`GET /v1/designation_groups/{id}`

This request lets you retrieve a single designation group from your Fundraise Up account. A designation group is a container for related designations and other designation groups.

## Path parameters

- `id` string, required

## Query parameters

- `livemode` boolean

## Response `200`

On success, the API returns the designation group object. If the provided identifier is invalid or no matching group exists for the current account, the request returns an error.

- DesignationGroupResponse — Contains designation group record with full details.
  - `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
            - ChildDesignation — A designation that belongs to a designation group.
              - …
            - ChildGroup — recursive
        - `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.

## Other responses

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

---

[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)