Skip to main content
GET
/
conversations
List conversations
curl --request GET \
  --url https://app.leonar.app/api/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "<string>",
      "unread_count": 123,
      "last_message_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "contact": {
        "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,
        "custom_data": {
          "industry_code": "A12",
          "vip": true
        },
        "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_

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
​
channel
enum<string>
Available options:
email,
linkedin,
whatsapp
​
status
string
​
unread_only
boolean
default:false
​
contact_id
string<uuid>
​
sort
string
default:-last_message_at

Options: last_message_at, created_at, unread_count

Response

List of conversations

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