Get a donor. | AwardSpring API

{
  "object": "string",
  "quick_stats": {
    "object": "string",
    "lifetime_total": 1.1,
    "lifetime_gift_count": 1,
    "year_total": 1.1,
    "year_gift_count": 1,
    "last_gift": 1.1,
    "last_gift_date": "2024-01-15T09:30:00Z",
    "include_soft_credits": true
  },
  "id": 1,
  "first_name": "string",
  "last_name": "string",
  "email": "string",
  "phone": "string",
  "role": "Individual",
  "date_of_birth": "2024-01-15T09:30:00Z",
  "birth_month": "string",
  "birth_day": 1,
  "birth_year": 1,
  "address1": "string",
  "address2": "string",
  "city": "string",
  "state": "string",
  "county": "string",
  "zip_code": "string",
  "country": 1,
  "job_title": "string",
  "work_email": "string",
  "work_phone": "string",
  "company_name": "string",
  "organization_name": "string",
  "public_organization_name": "string",
  "make_profile_private": true,
  "public_first_name": "string",
  "public_last_name": "string",
  "website": "string",
  "facebook_url": "string",
  "twitter_url": "string",
  "linked_in_url": "string",
  "photo_url": "string",
  "description": "string",
  "notes": "string",
  "include_soft_credits": true
}

Includes giving totals for the donor’s lifetime and the current year, their most recent gift, and their notes. Returns 404 donor_not_found if no such donor belongs to this institution.

Authentication

X-Spring-API-Keystring

Secret API key issued per institution. Send it on every request.

Path parameters

idintegerRequired

Response

objectstring or nullOptionalRead-only

Stripe-style resource discriminator. Stable, snake_case string naming the resource type. Serialized first so it reads as the leading field of every V1 resource body.

quick_statsobjectOptional

idintegerOptional

first_namestring or nullOptional

last_namestring or nullOptional

emailstring or nullOptional

phonestring or nullOptional

roleenum or nullOptional

Whether this is an individual donor or a donor organization: Individual or Organization. Mirrors the role field on the create request.

date_of_birthdatetime or nullOptional

birth_monthstring or nullOptional

birth_dayinteger or nullOptional

birth_yearinteger or nullOptional

address1string or nullOptional

address2string or nullOptional

citystring or nullOptional

statestring or nullOptional

countystring or nullOptional

zip_codestring or nullOptional

countryinteger or nullOptional

job_titlestring or nullOptional

work_emailstring or nullOptional

work_phonestring or nullOptional

company_namestring or nullOptional

organization_namestring or nullOptional

public_organization_namestring or nullOptional

make_profile_privateboolean or nullOptional

public_first_namestring or nullOptional

public_last_namestring or nullOptional

websitestring or nullOptional

facebook_urlstring or nullOptional

twitter_urlstring or nullOptional

linked_in_urlstring or nullOptional

photo_urlstring or nullOptional

descriptionstring or nullOptional

notesstring or nullOptional

include_soft_creditsbooleanOptional

Errors

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

$	curl https://api.awardspring.com/api/v1/donors/1 \
>	-H "X-Spring-API-Key: <apiKey>"