Referencia API

Todo lo que necesitas para integrar Timbre en tu aplicación

URL Base

https://api.usatimbre.com

Autenticación

Incluye tu llave API en cada solicitud:

Authorization: Bearer tmb_tu_llave_api

Ver guía completa de autenticación

Explora la API

Perfiles

Gestiona usuarios y su información fiscal por RFC o ID.

Organizaciones

Administra empresas y sus miembros.

Facturación

Crea facturas desde tickets automáticamente.

Estado

Verifica la disponibilidad del servicio.

Respuestas

Exitosa

{
  "success": true,
  "data": {
    "id": "inv_abc123",
    "status": "completed",
    "pdf_url": "https://..."
  }
}

Error

{
  "success": false,
  "error": {
    "code": "INVALID_RFC",
    "message": "El RFC proporcionado no es válido"
  }
}

Códigos HTTP

Código	Significado
200	Solicitud exitosa
400	Error en los datos enviados
401	Llave API inválida o faltante
404	Recurso no encontrado
429	Demasiadas solicitudes
500	Error interno del servidor