API pública v0

Todo lo público del registro está disponible como JSON. Sin clave, sin cuenta y sin peajes: un endpoint, CORS abierto y respuestas cacheables.

La API se estrena con la plataforma del registro. El contrato v0 aquí documentado es el del lanzamiento; después llegará una v1 con endpoints de listado y búsqueda.

Endpoint

GET https://platform.thehumanbehind.com/api/v0/records/{slug}.json

slug es el identificador público de la ficha, el último segmento de la URL de su página (/r/<slug>).
Sin autenticación. Sin clave de API.
CORS: Access-Control-Allow-Origin: *, puedes llamarla directamente desde un navegador.
Caché: las respuestas se cachean 300 segundos. El objetivo no es la frescura perfecta, sino la verificabilidad.

Ejemplo

curl https://platform.thehumanbehind.com/api/v0/records/nova.json

Respuesta, 200 OK, application/json:

{
  "registry_code": "THB-2026-00117",
  "slug": "nova",
  "avatar_name": "Nova",
  "type": "avatar",
  "scope": "general",
  "operates_at": "https://instagram.com/nova.avatar",
  "responsible_name": "Maria Lopez",
  "status": "active",
  "verification_level": "registered",
  "verified_at": null,
  "registered_at": "2026-07-14T09:21:33.481205Z",
  "content_hash": "54a8995c2e0c1c4ab014c18d65243c6527e0f62ff456440ed74bf8473f2b10fc"
}

La respuesta contiene únicamente campos públicos. El correo del titular y los datos de su cuenta no forman parte de la superficie de la API, de forma estructural, no solo por política: la API lee de una vista de base de datos que sencillamente no los contiene.

Campos

Los campos son exactamente los campos públicos de la ficha documentados en Fichas. Dos merecen nota aquí:

verification_level: registered o verified; cuando es verified, verified_at lleva la fecha. Ver Verificación.
content_hash: el SHA-256 del snapshot del alta. Puedes recalcularlo con los propios campos de la respuesta siguiendo la receta pública exacta. Esa es la razón de ser de la API: la verificación independiente. El hash sella el snapshot tal como se registró el primer día, así que si un campo editable cambió después, verifica con los valores originalmente registrados, no con los editados.

Errores

Código	Significado
`200`	Ficha encontrada; cuerpo JSON como el de arriba.
`404`	No existe ninguna ficha con ese slug.
`410`	La ficha existió y se despublicó. El slug y el número THB jamás se reutilizan, así que el `410` es en sí mismo una forma de constancia: aquí hubo una ficha.

Desde JavaScript

const res = await fetch(
  "https://platform.thehumanbehind.com/api/v0/records/nova.json"
);
const ficha = await res.json();
console.log(ficha.registry_code); // "THB-2026-00117"

Uso razonable

La API es gratuita para cualquier uso razonable: incrustar una comprobación del sello en tu web, construir un buscador, investigar. Las respuestas se cachean en el borde; por favor, no bombardees el origen con tráfico que esquive la caché. Si necesitas acceso masivo o endpoints de listado, háblanos. Para eso está la v1.

Siguiente: Reclamaciones →