Skip to content

API Integration Overview


Integration with Sumatra is through a developer-friendly API. SDKs are available for most common frameworks.


The Sumatra API is a REST interface that accepts JSON events sent from your application and returns decisions in real time (e.g. personalization choices, recommendations, and fraud decisions). In most cases, no pre-processing of the JSON events is needed because the data structure is highly flexible and is configured with customizable schema within Sumatra.

Try it

Try out the API for yourself in a few minutes! Sign up for a free sandbox to get an API key. Then use the curl command below to call the API from the command line. Be sure to replace SUMATRA_API_KEY with your private key.

curl --request POST \
  --url '' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: SUMATRA_API_KEY' \
  --data '{
    "_type": "my_event_type"

Learn more in the API documentation.

SDKs & Integrations

SDKs that ease integration with the API are available for most common frameworks. Sumatra can also be added as a destination in Segment or Rudderstack.

Framework or data source Type Plan
Segment Client All plans
Rudderstack Client All plans
JavaScript Snippet Client All plans
JavaScript NPM Client All plans
Python Server All plans
Node.js Server All plans
Kafka Message broker Enterprise-only
Kinesis Message broker Enterprise-only