Skip to main content
GET
/
api
/
contacts
curl -X GET "https://app.horneross.com/api/contacts?limit=50&search=gmail" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "contacts": [
    {
      "id": "contact_abc123",
      "email": "maria@gmail.com",
      "phoneNumber": "+5491123456789",
      "firstName": "María",
      "lastName": "García",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    },
    {
      "id": "contact_def456",
      "email": "juan@gmail.com",
      "phoneNumber": null,
      "firstName": "Juan",
      "lastName": "Pérez",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-20T14:00:00Z",
      "updatedAt": "2024-01-20T14:00:00Z"
    }
  ],
  "count": 150
}

​
Endpoint

GET /api/contacts
Obtené todos los contactos de tu organización con paginación y búsqueda.

​
Headers

​
Authorization
string
required
Bearer token con tu API key. Formato: Bearer sk_live_xxx

​
Query Parameters

​
offset
number
default:"0"
Número de página para paginación (0-indexed)
​
limit
number
default:"100"
Cantidad de resultados por página
​
search
string
Buscar contactos por email (búsqueda parcial)
curl -X GET "https://app.horneross.com/api/contacts?limit=50&search=gmail" \
  -H "Authorization: Bearer sk_live_xxx"

​
Response

​
contacts
array
required
Array de contactos
​
count
number
required
Total de contactos que coinciden con los filtros (para paginación)
{
  "contacts": [
    {
      "id": "contact_abc123",
      "email": "maria@gmail.com",
      "phoneNumber": "+5491123456789",
      "firstName": "María",
      "lastName": "García",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    },
    {
      "id": "contact_def456",
      "email": "juan@gmail.com",
      "phoneNumber": null,
      "firstName": "Juan",
      "lastName": "Pérez",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-20T14:00:00Z",
      "updatedAt": "2024-01-20T14:00:00Z"
    }
  ],
  "count": 150
}

​
Paginación

Para paginar resultados, usá offset y limit: 
// Primera página
const page1 = await fetch('/api/contacts?offset=0&limit=50');

// Segunda página
const page2 = await fetch('/api/contacts?offset=1&limit=50');

// Tercera página
const page3 = await fetch('/api/contacts?offset=2&limit=50');
El offset representa el número de página (0-indexed), no el número de registros a saltar.