Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

GET /api/v1/contacts

​
Query parameters

FieldTypeRequiredDescription
limitintegernoPage size, default 50, max 100
cursorstringnoOpaque cursor returned by the previous page
searchstringnoCase-insensitive match on name or phone (1-100 chars)
sortstringnocreatedAt_desc (default) or name_asc

​
Success response 200

{
  "data": {
    "contacts": [
      {
        "id": "cnt_uuid",
        "name": "Awa Doe",
        "phone": "+33612345000",
        "tags": ["vip"],
        "temperature": null,
        "createdAt": "2026-04-01T10:00:00.000Z",
        "updatedAt": "2026-04-01T10:00:00.000Z"
      }
    ],
    "total": 240,
    "limit": 50,
    "sort": "createdAt_desc",
    "nextCursor": "MjAyNi0wNC0wMVQxMDowMDowMC4wMDBafGNudF91dWlk",
    "hasMore": true
  }
}

​
Notes

  • Pass the nextCursor value back as cursor to fetch the next page. Stop when hasMore is false or nextCursor is null.
  • The cursor encodes the sort tuple (createdAt|id or name|id). Do not mix sorts across pages.