---
title: "Get campaigns"
method: GET
path: "/v1/campaigns"
tags: ["Campaigns"]
---

# Get campaigns

`GET /v1/campaigns`

This request allows you to read your Fundraise Up campaign records. Only base campaign types are supported.

## Query parameters

- `livemode` boolean
- `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.
- `starting_after` string
- `ending_before` string
- `limit` integer
- `account` string
- `designation` string

## Response `200`

On success, the API returns the list of campaigns.

- CampaignsResponse — Provides a paginated response for campaigns.
  - `data` CampaignDetailResponse[], required — An array containing the campaign 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_page_url` string, nullable, required — Public URL of the campaign page.
    - `code` string, nullable, required — Campaign code, as set in the Dashboard.
    - `currency` 'shp' | 'eur' | 'aed' | 'afn' | 'xcd' | 'all' | 'amd' | 'aoa' | 'ars' | 'usd' | 'aud' | 'ang' | 'xcg' | 'awg' | 'azn' | 'bam' | 'bbd' | 'inr' | 'pkr' | 'bdt' | 'xof' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'myr' | 'bnd' | 'bob' | 'brl' | 'bsd' | 'btn' | 'nok' | 'zar' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'cdf' | 'xaf' | 'chf' | 'nzd' | 'clp' | 'cny' | 'cop' | 'crc' | 'cve' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'mad' | 'etb' | 'fjd' | 'fkp' | 'jpy' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'hrk' | 'htg' | 'huf' | 'idr' | 'ils' | 'isk' | 'jmd' | 'jod' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mzn' | 'nad' | 'xpf' | 'ngn' | 'nio' | 'sek' | 'npr' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sgd' | 'sll' | 'sle' | 'sos' | 'srd' | 'std' | 'svc' | 'szl' | 'thb' | 'tjs' | 'tnd' | 'top' | 'try' | 'ttd' | 'twd' | 'tzs' | 'uah' | 'uyu' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'yer' | 'zmw' | 'btc' | 'eth' | 'usdt' | 'usdc' | 'sol' | 'dot' | 'doge' | 'shib' | 'ltc' | 'bch' | 'xtz' | 'fil' | 'ftm' | 'gala' | 'paxg' | 'zec', required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
    - `designation_mode` 'select' | 'assign', required — Designation selection mode.
    - `designations` union[], required — Ordered list of designations and designation groups assigned to this campaign. Polymorphic array discriminated by `type` field.
      - union
        - CampaignDesignation — A designation assigned to the campaign.
          - `code` string, nullable, required — Designation code.
          - `frequencies` string[], required — Donation frequencies accepted for this designation in this campaign.
          - `id` string, required — Unique designation identifier.
          - `is_default` boolean, required — Indicates whether this is the pre-selected default designation in this campaign.
          - `name` string, required — Designation name.
          - `type` 'designation', required — Item type discriminator.
        - CampaignDesignationGroup — A designation group assigned to the campaign.
          - `children` union[], required — Designations or nested designation groups.
            - union
              - …
          - `id` string, required — Unique designation group identifier.
          - `name` string, required — Designation group name.
          - `type` 'designation_group', required — Item type discriminator.
    - `end_date` string, nullable, required — Timestamp in ISO 8601 format, indicating when the campaign ends in UTC. `null` if no end date is set.
    - `frequencies` CampaignFrequencyResponse[], required — Active donation frequencies for the campaign.
      - `minimum_amount` string, required — Minimum donation amount in the campaign currency.
      - `type` 'once' | 'daily' | 'weekly' | 'biweekly' | 'every4weeks' | 'monthly' | 'bimonthly' | 'quarterly' | 'semiannual' | 'annual', required — Frequency.
    - `id` string, required — Unique campaign identifier.
    - `name` string, required — Campaign name.
    - `status` 'active' | 'disabled' | 'auto_archive', required — Current status of the campaign.
    - `tags` string[], required — Campaign tags, as set in the Dashboard.
  - `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 campaigns.

---

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