---
title: "/getContributors"
description: "Get Contributors API Call. Returns all contributors found for a particular event. Production Endpoint: https://auctionconductor.com/API/getContributors Test Endpoint: https://actestserver.com/API/ ge…"
url: "https://help.aesauctions.com/article/y92lrdmi3y-get-contributors"
category: "API"
updated_at: "2026-02-27T21:12:48Z"
---

# /getContributors

### Get Contributors API Call

- Returns all contributors found for a particular event.

**Production Endpoint: https://auctionconductor.com/API/getContributors**

**Test Endpoint: https://actestserver.com/API/getEventContributor**

#### Accepted Data

| Parameter | Req’d | Format | Default | Description                                                                                 |
|-----------|-------|--------|---------|---------------------------------------------------------------------------------------------|
| event\_id | Y     | Number | (none)  | Unique identifier for the event. Organization assigned to the event must match the API key. |

#### **Return Values**

\* indicates data will always be returned

Parameter

Value

Description

contributor\_id*

number

Unique identifier for the contributor.

event\_contributor\_id*

number

Unique identifier for the contributor in relation to the event.

contributor\_types

string array

Contributor types for selected event contributor returned as array of string

first\_name*

text

Contributor first name

last\_name*

text

Contributor last name

cell

text

Contributor cell phone

email

text

Contributor email address

company

text

Contributor company name

alternate\_key

text

Contributor alternate identification key

bidder\_number

number

Event specific bidder number

household\_id

number

Unique identifier for the household the contributor belongs to

household\_name

text

Name of the household the contributor belongs to

is\_billing

boolean

Indicates if the contributor is the billing contact for their assigned household

address

text

Contributor mailing address line 1

address2

text

Contributor mailing address line 2

city

text

Contributor mailing address city

state

text

Contributor mailing address state

zip

text

When Country=USA:

5 digits or

5+4 digits with a dash (12345-1234)

All others: 10 characters

country

text

Contributor mailing address country

sms\_opt\_in

10 chars

Event specific Opt-in setting for optional SMS text messaging alerts.

notes\_check\_in

text

Event specific notes for check-in

vip

boolean

Event specific VIP setting

created\_by*

text

Possible responses include:

- Logged user (fname lname)
- "API" if purchased from the event microsite

created\_at*

timestamp

Date and time of the original transaction

last\_edited\_by*

text

Possible responses include:

- Logged user (fname lname)
- "API" if purchased from the event microsite

last\_edited\_at*

timestamp

Date and time of the edited transaction

group

text

The group name assigned by the ticket purchaser at checkout.

email\_opt

boolean

Indicates if the contributor has opted out of email communications for this event.

checked\_in

boolean

Indicates if the contributor has checked in to the event, either online via express check-in, or in-person.

arrived

boolean

Indicates if the contributor has arrived the event, either via QR code scan, or manual lookup.

bidding

boolean

Indicates if the contributor has placed any bids in the silent or live auctions.

#### Sample Call

```
{
   event_id: "2442"
}
```

#### Sample Response

```
[
},
  {
    "contributor_id": 37788,
    "event_contributor_id": 69751,
    "contributor_types": [
      "Sponsor",
      "Volunteer"
],
    "first_name": "John",
    "last_name": "Barry",
    "cell": null,
    "email": "john@barryroofing.com",
    "company": "Barry Roofing",
    "alternate_key": null,
    "bidder_number": null,
    "household_id": 38, 
    "household_name": The Barry Family, 
    "is_billing": true,
    "address": "123 Fake St",
    "address2": "Apt 103",
    "city": "Springfield",
    "country": "United States of America",
    "state": "Missouri",
    "zip": "12345",
    "sms_opt_in": false,
    "notes_check_in": null,
    "vip": false,
    "created_by": "Jon Doehling",
    "created_at": "2020-02-11 09:04:36PM",
    "last_edited_by": "Jon Doehling",
    "last_edited_at": "2020-02-21 12:01:15AM",
    "group": "AES",
    "email_opt": false,
    "checked_in": false,
    "arrived": false, 
    "bidding": false
},
  {
    "contributor_id": 37789,
    "event_contributor_id": 69752,
    "contributor_types": [
      "Sponsor",
      "Volunteer"
],
    "first_name": "Jonathan",
    "last_name": "Doehling",
    "cell": "(720) 988-4177",
    "email": "jon@aes-oc.com",
    "company": null,
    "alternate_key": null,
    "bidder_number": null,
    "primary_contributor_id": null,
    "address": "7 Cottage Hill Ln",
    "address2": null,
    "city": "Ladera Ranch",
    "country": "United States of America",
    "state": "CALIFORNIA",
    "zip": "92694",
    "sms_opt_in": false,
    "notes_check_in": null,
    "vip": false,
    "created_by": "Jon Doehling",
    "created_at": "2020-02-11 09:04:59PM",
    "last_edited_by": "Jenny Test",
    "last_edited_at": "2020-04-02 03:53:12PM",
    "group": null,
    "email_opt": false,
    "checked_in": true,
    "arrived": true, 
    "bidding": true
},
]
```