---
title: "Get supporters"
method: GET
path: "/v1/supporters"
tags: ["Supporters"]
---

# Get supporters

`GET /v1/supporters`

Use this request to retrieve a paginated list of supporter records from your Fundraise Up account. Each record includes the latest contact details and other supporter-level fields, matching the data shown in the Supporters view in the Dashboard.

## About supporter contact data

The `address`, `phone`, and `employer` fields in supporter records reflect the most recent information provided by the supporter.

These fields are updated automatically when:

* The supporter makes a new donation using the same email address.
* A donation or recurring plan is edited in the Dashboard.
* The supporter updates their details in the Donor Portal.

Installments do not update supporter-level contact data.

You can't edit supporter contact fields through the API. To change them, update the associated donation or recurring plan — in the Dashboard at any time, or through the API within 24 hours of creation. The supporter record will reflect the updated values automatically.

This behavior applies only to changes made after June 2, 2025. Data collected earlier is not updated retroactively.

### Tracking updates using the Events endpoint

To monitor changes to supporter contact data, use the [Events endpoint](https://api.fundraiseup.com/v1/docs/#/operations/GetEvents). The following events may indicate a change to supporter contact fields:

* `supporter.updated` — supporter-level data has changed.
* `donation.updated` — contact fields on a donation were modified.
* `recurring_plan.details_updated` — a recurring plan was edited.

When you receive one of these events, use the corresponding endpoints to retrieve updated data:

* `GET /supporters/{id}` — get supporter-level contact information.
* `GET /donations/{id}` — get contact details specific to a donation.
* `GET /recurring_plans/{id}` — get contact details specific to a recurring plan.

## 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

## Response `200`

On success, the API returns the list of supporters.

- SupportersResponse — Provides a paginated response for supporters.
  - `data` SupporterResponse[], 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.
    - `address` AddressResponse, required — Contains the mailing address details.
      - `city` string, nullable, required — City name
      - `country` string, required — [Two-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), in lowercase.
      - `line1` string, nullable, required — First address line.
      - `line2` string, nullable, required — Second address line.
      - `postal_code` string, nullable, required — Postal or ZIP code.
      - `region` string, nullable, required — Can refer to a region, state, or province.
    - `created_at` string, required — Timestamp in ISO 8601 format, indicating when the supporter was created, in UTC.
    - `email` string, nullable, required — Email address associated with the supporter.
    - `employer` EmployerResponse, required — Represents the employer information.
      - `name` string, required — Employer's name.
    - `employment_status` 'employed' | 'unemployed' | 'retired', nullable, required — The supporter's current employment status. Possible values: `employed`, `unemployed`, `retired`. Returns `null` if not collected. Only collected for US political organizations.
    - `first_name` string, nullable, required — First name of the supporter.
    - `id` string, required — Unique identifier for the supporter.
    - `language` 'en-US' | 'en-GB' | 'en-CA' | 'fr-CA' | 'fr-FR' | 'es' | 'nl' | 'no' | 'de' | 'de-x-informal' | 'fi-FI' | 'ar-001' | 'sv' | 'it' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'zh-TW' | 'ja' | 'ko' | 'hu' | 'da' | 'ru-RU' | 'es-US' | 'pl-PL' | 'he', required — Supporter's locale.
    - `last_name` string, nullable, required — Last name of the supporter.
    - `livemode` boolean, required — Test mode indicator. `true` for supporters in live mode, `false` for supporters in test mode.
    - `occupation` string, nullable, required — The supporter's current occupation. Returns `null` if not collected or if employment status is `unemployed` or `retired`. Max 200 characters.
    - `phone` string, nullable, required — Supporter's phone number.
    - `title` 'm' | 'mme' | 'mlle' | 'autre' | 'mx' | 'mr' | 'mrs' | 'miss' | 'ms' | 'sir' | 'dame' | 'lord' | 'lady' | 'dr' | 'prof' | 'rev' | 'fr' | 'dcn' | 'br' | 'sr' | 'frau' | 'herr' | 'frau dr.' | 'herr dr.' | 'frau prof.' | 'herr prof.', nullable, required — Supporter's title.
  - `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 supporters.

---

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