GET
/
contacts
/
v1
/
lists
/
all
/
contacts
/
all
Get all contacts
curl --request GET \
  --url https://api.hubapi.com/contacts/v1/lists/all/contacts/all
"\nExample GET URL:\nhttps://api.hubapi.com/contacts/v1/lists/all/contacts/all\n\n\nExample response:\n{\n  \"contacts\": [\n    {\n      \"addedAt\": 1390574181854,\n      \"vid\": 204727,\n      \"canonical-vid\": 204727,\n      \"merged-vids\": [\n        \n      ],\n      \"portal-id\": 62515,\n      \"is-contact\": true,\n      \"properties\": {\n        \"firstname\": {\n          \"value\": \"Bob\"\n        },\n        \"lastmodifieddate\": {\n          \"value\": \"1483461406481\"\n        },\n        \"company\": {\n          \"value\": \"\"\n        },\n        \"lastname\": {\n          \"value\": \"Record\"\n        }\n      },\n      \"form-submissions\": [\n        \n      ],\n      \"identity-profiles\": [\n        {\n          \"vid\": 204727,\n          \"saved-at-timestamp\": 1476768116149,\n          \"deleted-changed-timestamp\": 0,\n          \"identities\": [\n            {\n              \"type\": \"LEAD_GUID\",\n              \"value\": \"f9d728f1-dff1-49b0-9caa-247dbdf5b8b7\",\n              \"timestamp\": 1390574181878\n            },\n            {\n              \"type\": \"EMAIL\",\n              \"value\": \"mgnew-email@hubspot.com\",\n              \"timestamp\": 1476768116137\n            }\n          ]\n        }\n      ],\n      \"merge-audits\": [\n        \n      ]\n    },\n    {\n      \"addedAt\": 1392643921079,\n      \"vid\": 207303,\n      \"canonical-vid\": 207303,\n      \"merged-vids\": [\n        \n      ],\n      \"portal-id\": 62515,\n      \"is-contact\": true,\n      \"properties\": {\n        \"firstname\": {\n          \"value\": \"Ff_FirstName_0\"\n        },\n        \"lastmodifieddate\": {\n          \"value\": \"1479148429488\"\n        },\n        \"lastname\": {\n          \"value\": \"Ff_LastName_0\"\n        }\n      },\n      \"form-submissions\": [\n        \n      ],\n      \"identity-profiles\": [\n        {\n          \"vid\": 207303,\n          \"saved-at-timestamp\": 1392643921090,\n          \"deleted-changed-timestamp\": 0,\n          \"identities\": [\n            {\n              \"type\": \"EMAIL\",\n              \"value\": \"email_0be34aebe5@abctest.com\",\n              \"timestamp\": 1392643921079\n            },\n            {\n              \"type\": \"LEAD_GUID\",\n              \"value\": \"058378c6-9513-43e1-a13a-43a98d47aa22\",\n              \"timestamp\": 1392643921082\n            }\n          ]\n        }\n      ],\n      \"merge-audits\": [\n        \n      ]\n    }\n  ],\n  \"has-more\": true,\n  \"vid-offset\": 207303\n}"

Query Parameters

​
count
string

This parameter lets you specify the amount of contacts to return in your API call. The default for this parameter (if it isn't specified) is 20 contacts. The maximum amount of contacts you can have returned to you via this parameter is 100.

​
vidOffset
string

Used to page through the contacts. Every call to this endpoint will return a vid-offset value. This value is used in the vidOffset parameter of the next call to get the next page of contacts.

​
property
string

May be included multiple times. By default, only a few standard properties will be included in the response data. If you include the 'property' parameter, then you will instead get the specified property in the response. This parameter may be included multiple times to specify multiple properties. NOTE: Contacts only store data for properties with a value, so records with no value for a property will not include that property, even if the property is specified in the request URL.

​
propertyMode
string

One of value_only or value_and_history to specify if the current value for a property should be fetched, or the value and all the historical values for that property. Default is value_only.

​
formSubmissionMode
string

One of all, none, newest, oldest to specify which form submissions should be fetched. Default is newest.

​
showListMemberships
string

Boolean true or false to indicate whether current list memberships should be fetched for the contact. Default is false.

Response

200 - application/json

Successful response - For a given account, return all contacts that have been created in the account

The response is of type object.