Skip to main content
POST
/
events
/
batch
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/events/batch" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
	"events": [
      {
        "transaction_id": "__UNIQUE_ID__",
        "external_subscription_id": "__YOUR_SUBSCRIPTION_ID__",
        "code": "__BILLABLE_METRIC_CODE__",
        "timestamp": $(date +%s),
        "properties": {
          "custom_field": 12
        }
      }
    ]
  }'

{
  "events": [
    {
      "transaction_id": "transaction_1234567890",
      "lago_customer_id": null,
      "code": "storage",
      "timestamp": "2022-04-29T08:59:51.123Z",
      "lago_subscription_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "external_subscription_id": "sub_1234567890",
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "precise_total_amount_cents": "1234.56",
      "properties": {
        "gb": 10
      },
      "created_at": "2022-04-29T08:59:51Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://lago-dependabot-npm-and-yarn-yaml-2-8-3.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/events/batch" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
	"events": [
      {
        "transaction_id": "__UNIQUE_ID__",
        "external_subscription_id": "__YOUR_SUBSCRIPTION_ID__",
        "code": "__BILLABLE_METRIC_CODE__",
        "timestamp": $(date +%s),
        "properties": {
          "custom_field": 12
        }
      }
    ]
  }'

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Batch events payload

​
events
object[]
required

Response

Event received

​
events
object[]
required