Utilisation

GET https://api.kennmarq.com/v1/usage

Les marquages, les données renvoyées et les horodatages du mois pour l’environnement de la clé, avec les limites de votre offre. Fonctionne avec n’importe quelle clé valide : une clé de test voit le quota de test.

curl

curl https://api.kennmarq.com/v1/usage -H "Authorization: Bearer $KENNMARQ_API_KEY"

200 application/json

{
  "object": "usage",
  "plan": "free",
  "environment": "live",
  "period": {
    "id": "2026-10",
    "start": "2026-10-01T00:00:00.000Z",
    "end": "2026-11-01T00:00:00.000Z"
  },
  "marks": { "used": 412, "limit": 1000, "ceiling": 1000 },
  "data_out": { "bytes": 389214772, "limit_bytes": 1000000000 },
  "time_stamps": { "used": 0, "limit": 1000 },
  "rate_limit": { "calls_per_minute": 10 }
}

Champs de l’objet usage
Champ	Signification
`plan`	L’offre de votre organisation : free, indie, startup, scale ou enterprise.
`environment`	L’environnement de la clé : live ou test. Chacun a ses propres quotas.
`period`	Le mois civil décompté, en UTC. Les compteurs repartent de zéro à sa fin.
`marks`	Les marquages faits ce mois-ci, le quota du mois (limit), et jusqu’où ils peuvent aller (ceiling) : le quota, ou dix fois le quota avec une offre payante mensuelle, qui facture les dépassements.
`data_out`	Les octets de fichiers marqués renvoyés ce mois-ci, et le quota (1 Go = 10⁹ octets).
`time_stamps`	Les horodatages obtenus via POST /v1/tsa ce mois-ci, et leur quota.
`rate_limit`	Les appels par minute que chaque clé peut effectuer avec votre offre.

Les appels à cet endpoint comptent dans les appels par minute de la clé, mais jamais dans vos marquages.