Skip to main content
POST
/
contacts
/
search
Search contacts
curl --request POST \
  --url https://app.leonar.app/api/v1/contacts/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "name": "<string>",
  "title": "<string>",
  "company": "<string>",
  "location": "<string>",
  "contact_types": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "created_after": "2023-12-25",
  "created_before": "2023-12-25",
  "last_contacted_after": "2023-12-25",
  "last_contacted_before": "2023-12-25",
  "salary_min": 123,
  "salary_max": 123,
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sort_by": "<string>",
  "sort_direction": "asc",
  "limit": 50,
  "offset": 0
}
'
{
  "data": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "first_name": "Sophie",
      "last_name": "Martin",
      "title": "Senior Software Engineer",
      "current_company": "Doctolib",
      "location": "Paris, France",
      "linkedin_profile": "https://www.linkedin.com/in/sophie-martin",
      "emails": [
        {
          "email": "sophie@doctolib.com",
          "type": "work"
        }
      ],
      "phones": [
        {
          "phone": "+33612345678",
          "type": "personal"
        }
      ],
      "tags": [
        "frontend",
        "senior"
      ],
      "global_status": "new",
      "source": "linkedin",
      "summary": null,
      "skills": [
        "React",
        "TypeScript",
        "Node.js"
      ],
      "languages": [
        "French",
        "English"
      ],
      "years_experience": 8,
      "do_not_contact": false,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-20T14:00:00Z",
      "last_contacted_at": null,
      "archived_at": null
    }
  ],
  "meta": {
    "total": 142,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

API key starting with leo_

Body

application/json
query
string

Full-text search query

name
string

Search by name

title
string

Search by job title

company
string

Search by company name

location
string

Search by location

contact_types
string[]

Filter by contact types

tags
string[]

Filter by tags

created_after
string<date>
created_before
string<date>
last_contacted_after
string<date>
last_contacted_before
string<date>
salary_min
number
salary_max
number
project_id
string<uuid>

Contacts in a specific project

sequence_id
string<uuid>

Contacts in a specific sequence

sort_by
string
sort_direction
enum<string>
Available options:
asc,
desc
limit
integer
default:50
offset
integer
default:0

Response

Search results

data
object[]
meta
object
Example:
{
"total": 142,
"limit": 50,
"offset": 0,
"has_more": true
}