Skip to main content
POST
/
companies
/
{company_id}
/
events
/
ingest
Ingest Usage Events
curl --request POST \
  --url https://api.maplebilling.com/api/v1/companies/{company_id}/events/ingest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "item_id": "<string>",
      "properties": {},
      "timestamp": "<string>",
      "transaction_id": "<string>",
      "customer_id": "<string>",
      "customer_identifier": "<string>",
      "subscription_id": "<unknown>"
    }
  ]
}
'
{
  "enqueued": [
    {
      "timestamp": "<string>",
      "transaction_id": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

The idempotency key that will be used to ensure the request is only performed once

Path Parameters

​
company_id
string
required

The company ID with the prefix 'cmp_'.

Body

application/json
​
events
object[]
required

An array of events to ingest. You can have a maximum of 100 events for each batch

Maximum array length: 100

Response

200 - application/json

OK

​
enqueued
object[] | null

The list of enqueued event transaction IDs