---
title: "Get a designation"
method: GET
path: "/v1/designations/{id}"
tags: ["Designations"]
---

# Get a designation

`GET /v1/designations/{id}`

Use this request to retrieve a single designation by its unique identifier. Returns designation details including account, name, code, and default status.

## Path parameters

- `id` string, required

## Query parameters

- `livemode` boolean

## Response `200`

On success, the API returns the designation object.

- Designation — A designation represents a fund allocation category for donations.
  - `account` AccountResponse, required — Organization account information.
    - `code` string, nullable, required — Custom identifier for the organization, set as the Account code in the Fundraise Up account.
    - `id` string, required — Unique identifier of the organization in the format A[A-Z]{7}.
    - `name` string, required — The name of the organization as set in the Fundraise Up account.
  - `code` string, nullable, required — Designation code.
  - `created_at` string, required — Timestamp in ISO 8601 format, indicating when the designation was created in UTC.
  - `id` string, required — Unique designation identifier.
  - `is_default` boolean, required — Indicates whether this is the default designation for the account.
  - `name` string, nullable, required — Designation name.
  - `updated_at` string, required — Timestamp in ISO 8601 format, indicating when the designation was last updated in UTC.

## Other responses

- `403` — Forbidden. The API key does not have permission to access designations.
- `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)