Listar Contactos

Este endpoint te permite obtener un listado paginado de todos los contactos asociados a tu organización.

Detalles del Endpoint

• URL: /api/v1/public/contacts
• Método: GET
• Cabeceras obligatorias:
  • X-API-Key: Tu clave de desarrollador.
• Parámetros de consulta (Query Params):
  • limit (opcional, por defecto: 20): Cantidad máxima de contactos a retornar.
  • offset (opcional, por defecto: 0): Desplazamiento de paginación.
  • bot_id (opcional): Filtro para retornar solo los contactos gestionados por un bot Kino específico.

---

Ejemplos de Petición

cURL

curl -H "X-API-Key: kinoia_live_tu_api_key" \
  "http://localhost:9000/api/v1/public/contacts?limit=10"

Node.js (Axios)

import axios from 'axios';

const response = await axios.get('http://localhost:9000/api/v1/public/contacts', {
  params: { limit: 10 },
  headers: { 'X-API-Key': 'kinoia_live_tu_api_key' }
});

console.log(response.data);

Python (HTTPX)

import httpx

with httpx.Client() as client:
    response = client.get(
        "http://localhost:9000/api/v1/public/contacts",
        params={"limit": 10},
        headers={"X-API-Key": "kinoia_live_tu_api_key"}
    )
    print(response.json())

---

Respuesta Esperada (200 OK)

{
  "contacts": [
    {
      "id": "e0e26d2e-0a56-4b92-b430-c44d18ec06bd",
      "phone_number": "+5491100000000",
      "name": "Juan Perez",
      "email": "juan@perez.com",
      "bot_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "created_at": "2026-06-22T00:00:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}