Synchronously ingest billable events | Afternoon

import { AfternoonClient } from "afternoon-sdk";
async function main() {
    const client = new AfternoonClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.events.ingest({
        eventName: "api.request",
        idempotencyKey: "evt_abc123xyz",
        customerId: "cjld2cjxh0000qzrmn831i7rn",
        timestamp: new Date("2023-11-07T05:31:56Z"),
    });
}
main();

{
  "success": true,
  "status": "inserted",
  "request_id": "req_abc123",
  "usage_id": "cm5x9z8nv0000h85r7l9p2k1m",
  "cost": [
    {
      "amount": "120",
      "account_type": "pricing_unit",
      "pricing_unit_code": "api_call",
      "currency_code": "usd"
    }
  ],
  "customer_balances": [
    {
      "balance": "980",
      "account_type": "pricing_unit",
      "pricing_unit_code": "api_call",
      "currency_code": "usd"
    }
  ],
  "error": {
    "code": "DATABASE_ERROR",
    "message": "Failed to insert event"
  }
}

Accepts a single billable event and inserts it synchronously into the database.

Authentication

AuthorizationBearer

API key obtained from the Afternoon dashboard

Request

This endpoint expects an object.

event_namestringRequired1-255 characters

Name of the event

idempotency_keystringRequired1-255 characters

Unique key to prevent duplicate event processing

customer_idstringRequiredformat: "cuid"

Customer identifier

timestampdatetimeRequired

Event timestamp in ISO 8601 UTC format (Z or +00:00)

propertiesmap from strings to anyOptional

Additional event properties

Response

Events processed synchronously

successboolean

statusenum

Processing outcome for the submitted event

Allowed values:

request_idstring

Request ID for tracing

usage_idstring

Created or existing billable event ID

costlist of objects

Aggregated event cost by wallet denomination. Present on successful requests.

customer_balanceslist of objects

Current customer wallet balances across denominations after ingestion.

errorobject

Errors

400

Bad Request Error

401

Unauthorized Error

413

Content Too Large Error

429

Too Many Requests Error

500

Internal Server Error