QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Api

Uso del sandbox hoy

Devuelve el consumo de pruebas del día (hora de Guatemala, UTC-6) desglosado por tipo de DTE, junto con el límite diario del plan.

GET
/v1/sandbox/usage

Autorización

ApiKeyAuth
AutorizaciónBearer <token>

API key con prefijo qapi_test_ (Sandbox) o qapi_live_ (producción), enviada en el header Authorization: Bearer <api_key>. Se genera en el dashboard, dentro de cada proyecto.

Va en: header

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/sandbox/usage"
{
  "date": "2026-06-09",
  "usage": {
    "FACT": 3
  },
  "limit_per_type": 30,
  "total_today": 3
}
{
  "type": "https://docs.dtevia.com.gt/errors/invalid-api-key",
  "title": "INVALID_API_KEY",
  "status": 401,
  "detail": "API key inválida o revocada",
  "instance": "/v1/sandbox/usage"
}
{
  "type": "https://docs.dtevia.com.gt/errors/email-not-verified",
  "title": "EMAIL_NOT_VERIFIED",
  "status": 403,
  "detail": "Confirmá el correo de tu cuenta para usar Facturas y Sandbox.",
  "instance": "/v1/sandbox/usage"
}
{
  "type": "https://docs.dtevia.com.gt/errors/rate-limited",
  "title": "RATE_LIMITED",
  "status": 429,
  "detail": "Límite de requests excedido. Reintentar en 60s",
  "instance": "/v1/invoices"
}
{
  "type": "https://docs.dtevia.com.gt/errors/internal-error",
  "title": "INTERNAL_ERROR",
  "status": 500,
  "detail": "Error interno del servidor",
  "instance": "/v1/invoices"
}