> For the complete documentation index, see [llms.txt](https://developer.ivvy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.ivvy.com/contact/get-contact-list.md).

# Get Contact List

## Get Contact List

<mark style="color:green;">`POST`</mark> `[PlatformAddress]/api/1.0/contact?action=getContactList`

Get Contact List will respond with a list of contacts based on the filter parameters

#### Path Parameters

| Name    | Type    | Description                                                                                                         |
| ------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| perPage | integer | The number of events to get in a single api call                                                                    |
| start   | integer | The starting result of the page. Note this is zero based (i.e. sending start = 0 will start from the first result.) |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Additional [Filter](/getting-started/interpreting-the-response/filtering.md) Properties

| Property         | Description                    | Type                                                                |
| ---------------- | ------------------------------ | ------------------------------------------------------------------- |
| fromModifiedDate | Filter by Modified Date        | [iVvy Timestamp Format](/development-reference/timestamp-format.md) |
| toModifiedDate   | Filter by Modified Date        | [iVvy Timestamp Format](/development-reference/timestamp-format.md) |
| externalId       | Filter by external unique id   | Unique external Id in string                                        |
| venueId          | Filter by specific Venue       | integer                                                             |
| venueGroupId     | Filter by specific Venue Group | integer                                                             |
| companyId        | Filter by specific Company Id  | integer                                                             |

## Returns

| Property           | Description                                                                                                      |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- |
| id                 | The unique identifier for the contact                                                                            |
| firstName          | The contact’s first name                                                                                         |
| lastName           | The contact’s last name                                                                                          |
| email              | The contact’s email address                                                                                      |
| phone              | The contact’s phone number                                                                                       |
| privacyConsentData | The object of [Privacy Consent](/contact/get-contact.md#privacy-consent-data) field objects of the contact.      |
| customFields       | The custom field information for the contact. This is an array of fields, each an object with the [keys](#keys). |
| groups             | The subscription group information for the contact.                                                              |
| companies          | This will an array company ids to which the contact belongs.                                                     |
| companiesData      | This will an array company containing id and businessName for each company to which the contact belongs.         |
| externalId         | This will be external id of the contact                                                                          |
| modifiedDate       | The modified date of the contact                                                                                 |
| isAnonymised       | Whether or not contact data is annonymised                                                                       |

## keys

| fieldId     |
| ----------- |
| displayName |
| value       |

The result from this call will be a [collection](/getting-started/interpreting-the-response/collections.md) of all the events the user has access to. This call also accepts the [pagination](/getting-started/interpreting-the-response/pagination.md) and [filter](/getting-started/interpreting-the-response/filtering.md) properties.