# Search Contacts

- **URL:** https://marketplace.gohighlevel.com/docs/ghl/contacts/search-contacts-advanced
- **Summary:** Search contacts based on combinations of advanced filters. Documentation Link - https://doc.clickup.com/8631005/d/h/87cpx-158396/6e629989abe7fad

[Skip to main content](https://marketplace.gohighlevel.com/docs/ghl/contacts/search-contacts-advanced#__docusaurus_skipToContent_fallback)

Version: v3

Search Contacts
===============

POST 

https://services.leadconnectorhq.com/contacts/search

Copy for LLMView as MarkdownOpen in ClaudeOpen in ChatGPTOpen in Cursor

Search contacts based on combinations of advanced filters. Documentation Link - [https://doc.clickup.com/8631005/d/h/87cpx-158396/6e629989abe7fad](https://doc.clickup.com/8631005/d/h/87cpx-158396/6e629989abe7fad)

### Requirements

#### Scope(s)

`contacts.readonly`

#### Auth Method(s)

`OAuth Access Token``Private Integration Token`

#### Token Type(s)

`Sub-Account Token`

Request[​](https://marketplace.gohighlevel.com/docs/ghl/contacts/search-contacts-advanced#request "Direct link to request")

### Header Parameters

**Version** stringrequired

**Possible values:** \[`v3`\]

API Version

**Example:** `v3`

*   application/json

*   Body
*   Example (auto)

### Body**required**

object

    {}

Responses[​](https://marketplace.gohighlevel.com/docs/ghl/contacts/search-contacts-advanced#responses "Direct link to Responses")

*   200
*   400
*   401

Success

Bad Request

Unauthorized

Share your feedback
-------------------

★★★★★

#### Authorization: Authorization

**name:** [Authorization](https://marketplace.gohighlevel.com/docs/ghl/contacts/contacts-api-v-3#authentication)
**type:** http**scopes:** `contacts.readonly`**scheme:** bearer**bearerFormat:** JWT**in:** header**description:** Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

*   curl
*   nodejs
*   python
*   php
*   java
*   go
*   ruby
*   powershell

*   CURL

    curl -L 'https://services.leadconnectorhq.com/contacts/search' \-H 'Content-Type: application/json' \-H 'Version: v3' \-H 'Authorization: Bearer <Authorization>' \-d '{}'

RequestCollapse all

Base URL

Edit

https://services.leadconnectorhq.com

Auth

Bearer Token

Parameters

Version — headerrequired\---v3

Body required

{}
Send API Request

ResponseClear

Click the `Send API Request` button above and see the response here!