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
}