API reference

usage.daily_settled

Sent once a UTC day of usage is settled, with the day's checks and what they cost, for live and test traffic.

POSThttps://your-server.example.com/webhooks/fingerly Signed by Fingerly

Sent after each UTC day is settled, shortly after midnight UTC: one event for live traffic and one for test traffic. Use it to reconcile your own records with what you were charged.

Body

  • idstring
    The event's ID, a UUIDv7. The same on every retry: deduplicate on it. Also sent as X-Fingerly-Event-ID.
  • typestring
    Always usage.daily_settled.
  • versioninteger
    The envelope version, 1.
  • organization_idstring
    Your organization.
  • environmentstring
    live for production traffic, test for staging and development.
  • created_atstring
    When the underlying fact happened, RFC 3339 in UTC. Not when it was delivered.
  • dataobject
    The settled day.
    6 child fields
    • datestring
      The UTC day, YYYY-MM-DD.
    • checksinteger
      Identify requests that day.
    • billable_checksinteger
      Checks that were billable. Always 0 for test.
    • refused_checksinteger
      Requests refused for rate limiting or credit.
    • billed_microsinteger
      What the billable checks cost, in millionths of a US dollar.
    • charged_microsinteger
      What was charged to your balance at settlement, in millionths of a US dollar.

test sums your staging and development keys. Divide micros by 1,000,000 for dollars: 3000 micros is $0.003.