Skip to main content
GET
/
contacts
List contacts
curl --request GET \
  --url https://app.leonar.app/api/v1/contacts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "first_name": "Sophie",
      "last_name": "Martin",
      "title": "Senior Software Engineer",
      "current_company": "Doctolib",
      "location": "Paris, France",
      "emails": [
        {
          "email": "sophie@doctolib.com",
          "type": "work"
        }
      ],
      "custom_data": {
        "industry_code": "A12"
      },
      "tags": [
        "frontend",
        "senior"
      ],
      "global_status": "new",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-20T14:00:00Z"
    }
  ],
  "meta": {
    "total": 142,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Authorizations

​
Authorization
string
header
required

API key starting with leo_

Query Parameters

​
limit
integer
default:50

Items per page

Required range: 1 <= x <= 100
​
offset
integer
default:0

Items to skip

Required range: x >= 0
​
search
string

Search by full name, company, title, or LinkedIn URL/identifier

​
contact_type
string

Filter by contact type

​
company_id
string<uuid>

Filter by company

​
location
string

Filter by location

​
global_status
enum<string>
default:all

Filter by status

Available options:
new,
contacted,
replied,
bounced,
do_not_contact,
archived,
all
​
created_after
string<date>

Contacts created after this date

​
created_before
string<date>

Contacts created before this date

​
sort
string
default:-created_at

Sort field. Prefix with - for descending. Options: created_at, updated_at, first_name, last_name, last_contacted_at

Response

List of contacts

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