Backfill Events - Dojah Inc

curl --request POST \
  "https://ingest.dojah.io/api/ingest/backfill" \
  -H "Authorization: {{secret_key}}" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "{{ingest_key}}",
    "type": "banking",
    "event": {
      "transaction": {
        "id": "87554303-3f75-4883",
        "time": "2022-08-01T09:20:00.000Z",
        "amount": 15400,
        "currency": "NGN",
        "type": "transfer"
      },
      "user": {
        "user_id": "9931fac0-6bfa-4b3c",
        "registration_time": "2021-05-10T08:00:00.000Z"
      }
    }
  }'

const res = await fetch("https://ingest.dojah.io/api/ingest/backfill", {
  method: "POST",
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    key: process.env.DOJAH_INGEST_KEY,
    type: "banking",
    event: {
      transaction: {
        id: "87554303-3f75-4883",
        time: "2022-08-01T09:20:00.000Z",
        amount: 15400,
        currency: "NGN",
        type: "transfer",
      },
      user: {
        user_id: "9931fac0-6bfa-4b3c",
        registration_time: "2021-05-10T08:00:00.000Z",
      },
    },
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://ingest.dojah.io/api/ingest/backfill",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "key": os.environ["DOJAH_INGEST_KEY"],
        "type": "banking",
        "event": {
            "transaction": {
                "id": "87554303-3f75-4883",
                "time": "2022-08-01T09:20:00.000Z",
                "amount": 15400,
                "currency": "NGN",
                "type": "transfer",
            },
            "user": {
                "user_id": "9931fac0-6bfa-4b3c",
                "registration_time": "2021-05-10T08:00:00.000Z",
            },
        },
    },
)
data = res.json()

{
  "status": "accepted",
  "message": "Events queued for backfill processing"
}

POST/api/ingest/backfill

Upload historical events that occurred before you integrated the real-time API. Fraud models need past data to learn what “normal” looks like — a user’s usual login locations, transaction amounts, and timing — so early real-time scoring is accurate.

Endpoint

Method	URL
POST	`https://ingest.dojah.io/api/ingest/backfill`

Headers

Header	Required	Description
`Authorization`	Yes	Your private/secret key, sent as-is — not `Bearer`.
`Content-Type`	Yes	`application/json`.

Body parameters

Backfill takes the same payload as the real-time endpoint — see the banking, payments, and onboarding templates for the full field list.

Parameter	Type	Required	Description
`key`	string	Yes	Your Ingest key from EasyDetect settings.
`type`	string	Yes	Event type: `banking`, `payments`, or `onboarding`.
`event`	object	Yes	The historical event payload, using the same nested objects as a real-time event.

Response

Backfilled events are accepted for training and are not scored in real time, so no per-event verdict is returned. Batches are processed asynchronously; monitor progress from EasyDetect on your dashboard.

Errors

Code	Meaning
`400`	Bad request — `type` is invalid or a required field is missing.
`401`	Unauthorized — check your `Authorization` key (no `Bearer` prefix) and body `key`.
`422`	Unprocessable — an event in the batch failed validation.
`429`	Too many requests — back off and retry.

curl --request POST \
  "https://ingest.dojah.io/api/ingest/backfill" \
  -H "Authorization: {{secret_key}}" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "{{ingest_key}}",
    "type": "banking",
    "event": {
      "transaction": {
        "id": "87554303-3f75-4883",
        "time": "2022-08-01T09:20:00.000Z",
        "amount": 15400,
        "currency": "NGN",
        "type": "transfer"
      },
      "user": {
        "user_id": "9931fac0-6bfa-4b3c",
        "registration_time": "2021-05-10T08:00:00.000Z"
      }
    }
  }'

const res = await fetch("https://ingest.dojah.io/api/ingest/backfill", {
  method: "POST",
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    key: process.env.DOJAH_INGEST_KEY,
    type: "banking",
    event: {
      transaction: {
        id: "87554303-3f75-4883",
        time: "2022-08-01T09:20:00.000Z",
        amount: 15400,
        currency: "NGN",
        type: "transfer",
      },
      user: {
        user_id: "9931fac0-6bfa-4b3c",
        registration_time: "2021-05-10T08:00:00.000Z",
      },
    },
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://ingest.dojah.io/api/ingest/backfill",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "key": os.environ["DOJAH_INGEST_KEY"],
        "type": "banking",
        "event": {
            "transaction": {
                "id": "87554303-3f75-4883",
                "time": "2022-08-01T09:20:00.000Z",
                "amount": 15400,
                "currency": "NGN",
                "type": "transfer",
            },
            "user": {
                "user_id": "9931fac0-6bfa-4b3c",
                "registration_time": "2021-05-10T08:00:00.000Z",
            },
        },
    },
)
data = res.json()

{
  "status": "accepted",
  "message": "Events queued for backfill processing"
}