Skip to main content
POST
/
v1
/
machine-data
/
import-jobs
Ingest machine data (asynchronous import)
curl --request POST \
  --url https://api.cula.tech/tracking/v1/v1/machine-data/import-jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "timestamp": "2025-10-25T13:02:52.932+02:00",
      "machine_data_point_config_id": "mdp_01kqzcjrpyf27tge9dnvsqv8t2",
      "value": 33.3
    },
    {
      "timestamp": "2025-10-25T13:02:52.932+02:00",
      "machine_data_point_config_id": "mdp_01kqzcjrpyf27tge33jwvjhkff",
      "value": 62.1
    },
    {
      "timestamp": "2025-10-25T13:03:52.932+02:00",
      "machine_data_point_config_id": "mdp_01kqzcjrpyf27tge9dnvsqv8t2",
      "value": 34.7
    }
  ]
}
'
{
  "job_id": "job_01kqzcjrpyf27tge33jwvjhkff",
  "status": "accepted",
  "items_received": 25123,
  "items_accepted": null,
  "items_rejected": null,
  "errors": null,
  "created_at": "2026-05-06T10:15:32.441Z",
  "finished_at": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.cula.tech/llms.txt

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

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token. Keys are scoped to one organisation and a set of permitted sites. Two keys per scope (primary + secondary) are issued to support zero-downtime rotation.

Authorization: Bearer <api-key>

Body

application/json

Batch of machine data items for synchronous ingestion. Maximum 200 items.

​
items
object[]
required

Array of machine data measurements to ingest.

Required array length: 1 - 200 elements

Response

Import job accepted for processing.

Status of an asynchronous machine data import job.

​
job_id
string
required
Example:

"job_01kqzcjrpyf27tge33jwvjhkff"

​
status
enum<string>
required

Current state of the import job.

Available options:
accepted,
processing,
finished,
failed
Example:

"finished"

​
items_received
integer
required
Example:

25123

​
created_at
string<date-time>
required
Example:

"2026-05-06T10:15:32.441Z"

​
items_accepted
integer | null
Example:

25121

​
items_rejected
integer | null
Example:

2

​
errors
object[] | null
​
finished_at
string<date-time> | null
Example:

"2026-05-06T10:35:32.441Z"