---
title: "Get designation configurations"
method: GET
path: "/v1/designation_configurations"
tags: ["Designation configurations"]
---

# Get designation configurations

`GET /v1/designation_configurations`

Use this request to retrieve a paginated list of designation configurations from your Fundraise Up account. Each configuration represents a relationship between a designation and a campaign, and specifies which payment frequencies are allowed.

## Query parameters

- `livemode` boolean
- `starting_after` string
- `ending_before` string
- `limit` integer
- `campaign` string
- `designation` string
- `repeat` 'recurring' | 'one-time' | 'all'

## Response `200`

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

- DesignationConfigurationsResponse — Provides a paginated response for designation configurations.
  - `data` DesignationConfigurationResponse[], required — An array containing the entity records, paginated by any request parameters.
    - `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.
    - `campaign` CampaignResponse, required — Provides details about the campaign.
      - `code` string, nullable, required — Campaign code, as set in the Dashboard.
      - `id` string, required — Unique campaign identifier.
      - `name` string, required — Campaign name.
    - `created_at` string, required — Timestamp in ISO 8601 format, indicating when the configuration was created in UTC.
    - `designation` DesignationResponse, required — Contains information about the designation.
      - `code` string, nullable, required — Designation code.
      - `id` string, required — Unique designation identifier.
      - `name` string, nullable, required — Designation name.
    - `id` string, required — Unique identifier for the designation configuration.
    - `repeat` 'recurring' | 'one-time' | 'all', required — Indicates payment types accepted for this designation-campaign combination.
  - `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 designations.

---

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