API · Versión 1

La API de Genealogic.

Accede a tus perros, camadas y datos del criadero en tiempo real desde aplicaciones externas como Pawdoq Breeders u otros chatbots / CRMs.

01Quick start

Empieza en 3 pasos

01Genera una API key en Mi Criadero → API.
02Cópiala y guárdala (solo se muestra una vez).
03Llama a la API con header Authorization: Bearer gnl_….

02Autenticación

Bearer token por kennel

Todos los endpoints requieren una API key válida en el header HTTP:

curl https://www.genealogic.io/api/v1/kennel \
  -H "Authorization: Bearer gnl_tu_api_key"

La API key está vinculada a un único criadero. Las respuestas se filtran automáticamente al criadero propietario de la key.

03Endpoints

Recursos disponibles

GET/api/v1/kennel

Información completa del criadero (nombre, web, RRSS, WhatsApp, fecha de fundación).

Ver respuesta de ejemplo

{
  "id": "uuid",
  "name": "Irema Curtó",
  "slug": "irema-curto",
  "website": "https://iremacurto.com",
  "social_instagram": "...",
  "whatsapp_phone": "+34685343971",
  "foundation_date": "1975-01-01"
}

GET/api/v1/dogs

Lista de perros del criadero (públicos).

Query params

sex — 'male' | 'female'
for_sale — 'true' | 'false'
reproductive — 'true' | 'false'
limit — 1–100 (default 50)
offset — 0+ (default 0)

Ver respuesta de ejemplo

{
  "data": [
    {
      "id": "uuid",
      "name": "Sirio de L'Argentería",
      "slug": "sirio-de-largenteria",
      "sex": "male",
      "birth_date": "2017-04-15",
      "thumbnail_url": "https://…",
      "is_for_sale": false,
      "is_reproductive": true,
      "breed": { "id": "...", "name": "Galgo Italiano" },
      "color": { "id": "...", "name": "Leonado" }
    }
  ],
  "pagination": { "total": 42, "limit": 50, "offset": 0 }
}

GET/api/v1/dogs/:slug

Un perro concreto con genealogía completa (5 generaciones) y galería de fotos.

GET/api/v1/litters

Camadas del criadero (públicas).

Query params

status — 'planned' | 'mated' | 'born'
limit — 1–100 (default 50)
offset — 0+ (default 0)

GET/api/v1/litters/upcoming

Camadas planificadas o en gestación. Optimizado para chatbots respondiendo "¿hay camadas próximamente?"

GET/api/v1/litters/available-puppies

Cachorros y perros listos para vender. Para chatbots respondiendo "¿hay cachorros disponibles?"

GET/api/v1/breeds

Razas que cría este kennel (basado en los perros que tiene registrados).

PATCH/api/v1/dogs/:slug

Actualiza datos de venta o reproducción de un perro. Pensado para que apps externas (Pawdoq) marquen un perro como vendido al cobrar la seña.

Body (JSON, todos opcionales)

is_for_sale — boolean
sale_price — number | null
sale_currency — string | null
sale_description — string | null
sale_location — string | null
sale_zipcode — string | null
sale_reservation_price — number | null
is_reproductive — boolean
breeding_rights — boolean

GET/api/v1/litters/:id

Una camada concreta del criadero.

PATCH/api/v1/litters/:id

Avanza el estado de una camada (planificada → cubrición → nacimiento → confirmada) o ajusta fechas y nº de cachorros.

Body (JSON, todos opcionales)

status — 'planned' | 'mated' | 'born' | 'confirmed'
mating_date — ISO date | null
birth_date — ISO date | null
puppy_count — number | null
is_public — boolean

04Errores

Códigos HTTP

Código	Significado
401	API key faltante, inválida o revocada
403	El recurso no es público o no pertenece al kennel
404	Recurso no encontrado
500	Error del servidor

05Rate limits

Sin límites estrictos por ahora

Si abusas, te capamos. Recomendado: cachear respuestas en Pawdoq (TTL 60s) y usar webhooks para tiempo real.

Genealogic API v1 · 2026