Skip to main content
POST
/
server-events
/
batch
Send batch of server-side events
curl --request POST \
  --url https://track.scanova.io/server-events/batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "events": [
    {
      "site_id": "site_abc123",
      "event_name": "purchase",
      "scan_session_id": "550e8400-e29b-41d4-a716-446655440000",
      "conversion_value": {
        "amount": 99.99,
        "currency": "USD"
      },
      "user_identifiers": {
        "email_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
        "external_id": "user_12345"
      },
      "properties": {
        "order_id": "order_789",
        "product_ids": [
          "prod_1",
          "prod_2"
        ]
      }
    }
  ]
}
'
{
  "success": true,
  "accepted": 123,
  "rejected": 123,
  "event_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
Batch mode reduces HTTP overhead and is recommended for queued worker delivery.

Authorizations

X-API-Key
string
header
required

Site-scoped server API key generated from Dashboard > Integrations > Conversion Tracking > Script/API > API tab

Body

application/json
events
object[]
required
Required array length: 1 - 100 elements

Response

Batch processed

success
boolean
required
accepted
integer
required
rejected
integer
required
event_ids
string<uuid>[]
required