---
title: "List all contacts"
method: GET
path: "/v1/contacts"
tags: ["Contacts"]
---

# List all contacts

`GET /v1/contacts`

## Query parameters

- `type` 'individual' | 'company'
- `createdAfter` string, date-time, nullable
- `createdBefore` string, date-time, nullable
- `updatedAfter` string, date-time, nullable
- `updatedBefore` string, date-time, nullable
- `totalContributionsMin` number, nullable
- `totalContributionsMax` number, nullable
- `recurringContributionsMin` number, nullable
- `recurringContributionsMax` number, nullable
- `tags` string, nullable
- `sortBy` 'name_or_company' | 'primary_email' | 'point_of_contact' | 'created_at' | 'total_contributions' | 'recurring_contributions' | 'last_donation_amount', nullable
- `sortByDesc` 'name_or_company' | 'primary_email' | 'point_of_contact' | 'created_at' | 'total_contributions' | 'recurring_contributions' | 'last_donation_amount', nullable
- `email` string, nullable
- `primaryEmail` string, nullable
- `firstName` string, nullable
- `lastName` string, nullable

## Response `200`

Paginated set of `ContactResource`

- object
  - `data` ContactResource[], required
    - `id` string, required
    - `external_id` string, required
    - `contact_since` string, required
    - `type` string, required
    - `prefix` string, required
    - `first_name` string, required
    - `preferred_name` string, required
    - `middle_name` string, required
    - `last_name` string, required
    - `suffix` string, required
    - `gender` string, required
    - `pronouns` string, required
    - `dob` string, required
    - `company` string, required
    - `employer` string, required
    - `company_name` string, required
    - `point_of_contact` PointOfContactResource
      - `id` string, required
      - `type` string, required
      - `prefix` string, required
      - `first_name` string, required
      - `middle_name` string, required
      - `last_name` string, required
      - `suffix` string, required
      - `gender` string, required
      - `pronouns` string, required
      - `dob` string, required
      - `employer` string, required
      - `title` string, required
      - `twitter_url` string, required
      - `linkedin_url` string, required
      - `facebook_url` string, required
      - `tiktok_url` string, required
      - `instagram_url` string, required
      - `website_url` string, required
      - `emails` object, required
      - `phones` object, required
      - `primary_email` string, required
      - `primary_phone` string, required
      - `is_email_subscribed` string, required
      - `is_phone_subscribed` string, required
      - `is_address_subscribed` string, required
      - `address_unsubscribed_at` string, required
      - `archived_at` string, required
      - `created_at` string, required
      - `updated_at` string, required
      - `first_time_supporter_at` string, required
    - `associated_companies` AssociatedCompanyResource[], nullable
      - `id` string, required
      - `type` string, required
      - `company_name` string, required
      - `name_display` string, required
      - `title` string, required
      - `twitter_url` string, required
      - `linkedin_url` string, required
      - `facebook_url` string, required
      - `tiktok_url` string, required
      - `instagram_url` string, required
      - `website_url` string, required
      - `image_url` string, nullable, required
      - `emails` object, required
      - `phones` object, required
      - `primary_email` string, required
      - `primary_phone` string, required
      - `is_email_subscribed` string, required
      - `is_phone_subscribed` string, required
      - `is_address_subscribed` string, required
      - `address_unsubscribed_at` string, required
      - `note` string, required
      - `addresses` AddressResource[], required
        - `id` integer, required
        - `account_id` integer, nullable, required
        - `name` string, nullable, required
        - `address_1` string, required
        - `address_2` string, nullable, required
        - `city` string, required
        - `state` string, nullable, required
        - `zipcode` string, nullable, required
        - `country` string, required
        - `type` string, required
        - `is_primary` boolean, required
        - `created_at` string, date-time, nullable, required
        - `updated_at` string, date-time, nullable, required
      - `primary_address` AddressResource, required
        - `id` integer, required
        - `account_id` integer, nullable, required
        - `name` string, nullable, required
        - `address_1` string, required
        - `address_2` string, nullable, required
        - `city` string, required
        - `state` string, nullable, required
        - `zipcode` string, nullable, required
        - `country` string, required
        - `type` string, required
        - `is_primary` boolean, required
        - `created_at` string, date-time, nullable, required
        - `updated_at` string, date-time, nullable, required
      - `archived_at` string, required
      - `created_at` string, required
      - `updated_at` string, required
      - `first_time_supporter_at` string, required
    - `title` string, required
    - `website_url` string, required
    - `twitter_url` string, required
    - `linkedin_url` string, required
    - `facebook_url` string, required
    - `tiktok_url` string, required
    - `instagram_url` string, required
    - `emails` EmailResource[], required
      - `type` string, nullable, required
      - `value` string, nullable, required
    - `phones` PhoneResource[], required
      - `type` string, nullable, required
      - `value` string, nullable, required
    - `primary_email` string, required
    - `primary_phone` string, required
    - `note` string, required
    - `addresses` AppHttpResourcesAPIAddressResource[], required
      - `address_1` string, required
      - `address_2` string, nullable, required
      - `city` string, required
      - `state` string, nullable, required
      - `zipcode` string, nullable, required
      - `country` string, required
      - `type` string, required
      - `is_primary` boolean, required
      - `created_at` string, date-time, nullable, required
      - `updated_at` string, date-time, nullable, required
    - `primary_address` AppHttpResourcesAPIAddressResource, required
      - `address_1` string, required
      - `address_2` string, nullable, required
      - `city` string, required
      - `state` string, nullable, required
      - `zipcode` string, nullable, required
      - `country` string, required
      - `type` string, required
      - `is_primary` boolean, required
      - `created_at` string, date-time, nullable, required
      - `updated_at` string, date-time, nullable, required
    - `last_donation_amount` string, required
    - `stats` object, required
      - `total_contributions` string, required
      - `recurring_contributions` string, required
    - `tags` string, required
    - `custom_fields` unknown[], required
      - unknown
    - `external_ids` ExternalIdResource[], required
      - `id` integer, required
      - `label` string, required
      - `external_id` string, required
      - `created_at` string, required
      - `updated_at` string, required
    - `is_email_subscribed` string, required
    - `is_phone_subscribed` string, required
    - `is_address_subscribed` string, required
    - `email_opt_in` string, required
    - `sms_opt_in` string, required
    - `address_unsubscribed_at` string, required
    - `archived_at` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `salutation_name` string, required
  - `links` object, required
    - `first` string, nullable, required
    - `last` string, nullable, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object, required
    - `current_page` integer, required
    - `from` integer, nullable, required
    - `last_page` integer, required
    - `links` object[], required — Generated paginator links.
      - `url` string, nullable, required
      - `label` string, required
      - `active` boolean, required
    - `path` string, nullable, required — Base path for paginator generated URLs.
    - `per_page` integer, required — Number of items shown per page.
    - `to` integer, nullable, required — Number of the last item in the slice.
    - `total` integer, required — Total number of items being paginated.

## Other responses

- `403` — Authorization error
- `422` — Validation error

---

[API](https://skmtc.net/givebutter/apis/givebutter-api-documentation.md) · [All operations](https://skmtc.net/givebutter/apis/givebutter-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/givebutter/givebutter-api-documentation/revisions/b788722bbaf6/schema)