GoHighLevel Contacts API

Get Contacts

GET/contacts/

Deprecated by HighLevel

HighLevel has deprecated this endpoint. It may stop working without notice — build against the replacement instead.

Replacement: contacts/search-contacts-advanced

GET /contacts/ Get Contacts Note: This API endpoint is deprecated. Please use the Search Contacts endpoint instead It takes 5 query parameters, requires the contacts.readonly scope and authenticates with a sub-account (location) token.

Request and authentication

Method
GET
Full URL
https://services.leadconnectorhq.com/contacts/
Scopes
contacts.readonly
Token type
Sub-account (location) token
Accepted auth
OAuth Access Token, Private Integration Token
API version header
Version: 2021-07-28
Schema verified
22 June 2026

Notes from the field

  • DEPRECATED by GHL. Use contacts/search-contacts-advanced (POST /contacts/search) instead — this endpoint may stop working without notice.

Query parameters

Appended to the URL as a query string.

NameTypeDescription
locationIdrequiredstring

Example: ve9EPM428h8vShlRW1KT

startAfterIdstring

Example: UIaE1WjAwWKdlyD7osQI

startAfternumber

Example: 1603870249758

querystring

Example: John

limitnumber

Example: 20

Response fields

Top-level fields returned on a successful call.

NameTypeDescription
contactsarray—
countnumber

Example: 10

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token.

curl -X GET 'https://services.leadconnectorhq.com/contacts/' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricingRead the setup guide

More contacts endpoints