---
title: "Get a supporter"
method: GET
path: "/v1/supporters/{id}"
tags: ["Supporters"]
---

# Get a supporter

`GET /v1/supporters/{id}`

Use this request to retrieve a specific supporter record by its unique ID. The response includes all supporter-level fields available in the Dashboard, such as name, email, language, mailing address, phone number, employer, and others.

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

## Path parameters

- `id` string, required

## Query parameters

- `livemode` boolean

## Response `200`

On success, the API returns the supporter object.

- SupporterResponse — Contains supporter details.
  - `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.

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