---
title: "/getContributor"
description: "Get Contributor API Call. Retrieves an existing contributor in the AES database. A contributor may be linked to one or many events or campaigns. Production Endpoint: https://auctionconductor.com/API/…"
url: "https://help.aesauctions.com/article/y18cifgjpd-get-contributor"
category: "API"
updated_at: "2025-02-27T22:00:33Z"
---

# /getContributor

### Get Contributor API Call

- Retrieves an existing contributor in the AES database.
- A contributor may be linked to one or many events or campaigns.

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

**QA Staging Endpoint: https://actestserver.com/API/getContributor** 

#### Accepted Data

| Parameter       | Req’d | Format | Default | Description                                                        |
|-----------------|-------|--------|---------|--------------------------------------------------------------------|
| contributor\_id | Y     | number | (none)  | Contributor identification returned by the createContributor call. |

#### **Return Values**

\* indicates data will always be returned

Parameter

Value

Description

contributor\_id*

number

Contributor identification returned by the createContributor call.

first\_name*

text

Contributor first name

middle\_name

text

Contributor middle name

last\_name*

text

Contributor last name

company

text

Company or Group name

address1

text

Address first line

address2

text

Address second line

city

text

Address city

state

text

US State, non-abbreviated. Null for countries outside of the US.

country

text

Country name, 50 characters maximum

zip

text

When Country=USA:

5 digits or

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

All others: 10 characters

website

text

Website

email

text

Email

phone

text

Landline phone number in (xxx) xxx-xxxx format

cell

text

Cellular phone number, to be used in SMS text alerts in (xxx) xxx-xxxx format

salutation

text

Must be one of the following:  Ms., Mrs., Mr., Dr., Hon., Sis., Br., Mons.

fax

text

Fax number in (xxx) xxx-xxxx format

email\_opt

boolean

Contributor wishes to opt out of email communications

title

text

Occupation title

contributor\_since*

text (MM/dd/yyyy)

Date in which Contributor record was created

#### Sample Call

```
{
    "contributor_id": 35664
}
```

#### Sample Response

```
{
    "contributor_id": 35664,
    "first_name": "John",
    "last_name": "Smith",
    "middle_name": "James",
    "company": "AES",
    "address1": "123 Fake St.",
    "address2": "STE G-144",
    "city": "Englewood",
    "state": "Colorado"
    "country": "Unites States of America"
    "zip": "80108",
    "email": "john@aes.com",
    "phone": null,
    "cell": "1234567890",
    "salutation": "Mr.",
    "fax": null,
    "email_opt": false,
    "title": "President",
    "contributor_since": "01/01/2010"
}
```