Get Bulk Create Status

Get async bulk submission status

curl --request GET \
  --url https://api.tamradar.com/v1/radars/bulk/{bulk_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.tamradar.com/v1/radars/bulk/{bulk_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tamradar.com/v1/radars/bulk/{bulk_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tamradar.com/v1/radars/bulk/{bulk_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tamradar.com/v1/radars/bulk/{bulk_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "processing",
  "code": 200,
  "message": "Bulk submission is being processed",
  "timestamp": "2026-05-24T18:25:11.000Z",
  "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
  "summary": {
    "total": 3,
    "processing": 1,
    "created": 1,
    "failed": 1
  },
  "radars": [
    {
      "item_index": 0,
      "custom_fields": {
        "crm_account_id": "acc_001"
      },
      "status": "processing"
    },
    {
      "item_index": 1,
      "update_id": "efbf7c77-c1ae-4a0d-85b6-116674e9e0b1",
      "update_type": "radar_created",
      "record_id": null,
      "completed_at": "2026-05-24T18:24:58.000Z",
      "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
      "custom_fields": {
        "crm_account_id": "acc_002"
      },
      "data": {
        "radar_id": "2ffb1a07-ac95-4a6d-bc34-39f479f1c856",
        "updates_since": null
      }
    },
    {
      "item_index": 2,
      "update_id": "a1b2c3d4-0001-4000-b000-000000000001",
      "update_type": "radar_failure",
      "record_id": null,
      "completed_at": "2026-05-24T18:25:03.000Z",
      "discovered_at": "2026-05-24T18:25:03.000Z",
      "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
      "custom_fields": {},
      "status": "error",
      "code": 400,
      "message": "Radar creation failed: missing prerequisites.",
      "errors": [
        {
          "field": "radar",
          "reason": "missing_prerequisites"
        }
      ],
      "refund_amount_usd": 0,
      "timestamp": "2026-05-24T18:25:03.000Z",
      "error_id": "a1b2c3d4-0001-4000-b000-000000000001"
    }
  ]
}

GET

radars

bulk

{bulk_id}

Get async bulk submission status

curl --request GET \
  --url https://api.tamradar.com/v1/radars/bulk/{bulk_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.tamradar.com/v1/radars/bulk/{bulk_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tamradar.com/v1/radars/bulk/{bulk_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tamradar.com/v1/radars/bulk/{bulk_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tamradar.com/v1/radars/bulk/{bulk_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "processing",
  "code": 200,
  "message": "Bulk submission is being processed",
  "timestamp": "2026-05-24T18:25:11.000Z",
  "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
  "summary": {
    "total": 3,
    "processing": 1,
    "created": 1,
    "failed": 1
  },
  "radars": [
    {
      "item_index": 0,
      "custom_fields": {
        "crm_account_id": "acc_001"
      },
      "status": "processing"
    },
    {
      "item_index": 1,
      "update_id": "efbf7c77-c1ae-4a0d-85b6-116674e9e0b1",
      "update_type": "radar_created",
      "record_id": null,
      "completed_at": "2026-05-24T18:24:58.000Z",
      "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
      "custom_fields": {
        "crm_account_id": "acc_002"
      },
      "data": {
        "radar_id": "2ffb1a07-ac95-4a6d-bc34-39f479f1c856",
        "updates_since": null
      }
    },
    {
      "item_index": 2,
      "update_id": "a1b2c3d4-0001-4000-b000-000000000001",
      "update_type": "radar_failure",
      "record_id": null,
      "completed_at": "2026-05-24T18:25:03.000Z",
      "discovered_at": "2026-05-24T18:25:03.000Z",
      "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
      "custom_fields": {},
      "status": "error",
      "code": 400,
      "message": "Radar creation failed: missing prerequisites.",
      "errors": [
        {
          "field": "radar",
          "reason": "missing_prerequisites"
        }
      ],
      "refund_amount_usd": 0,
      "timestamp": "2026-05-24T18:25:03.000Z",
      "error_id": "a1b2c3d4-0001-4000-b000-000000000001"
    }
  ]
}

How bulk status works

After submitting a bulk request, the response transitions through two states:

processing — At least one item is still being created. summary.processing shows how many are in flight.
completed — All items have reached a terminal state (created or failed). No more changes.

Poll this endpoint until status = "completed", or — if you provided a webhook_url — wait for the bulk_completed webhook instead. For webhookless (poll-only) submissions, this endpoint is the tracking surface for every outcome, including failures.

Per-item fields

Each submitted item appears in radars[]. While it is running, the item contains only its index, custom fields, and processing status. Once it settles, the item contains either the created radar under data or the item-level error fields. Webhook correlation fields may also appear after webhook processing enriches the stored item payload.

Field	Present when	Description
`item_index`	Always	Zero-based position in the original `radars[]` array
`custom_fields`	Always	Custom fields passed on the item
`status`	Always	`"processing"`, `"success"`, or `"error"` for the item
`update_id`	After webhook enrichment	Correlation ID linking to the item’s `radar_created` or `radar_failure` webhook
`update_type`	After webhook enrichment	`radar_created` (success) or `radar_failure` (failure)
`completed_at`	After webhook enrichment	Timestamp added to the per-item webhook payload
`data`	Created items	Full radar object, including nullable `updates_since`, with the same shape as a single-radar creation response
`code` / `errors[]`	Failed items	HTTP error code and error details, same shape as sync API errors

Items are always returned ordered by item_index.

Re-fetch until the top-level status is "completed". The radars[] array includes all submitted items from the start; in-flight stubs are replaced by their success or failure fields as processing completes.

Authorizations

x-api-key

string

header

required

Path Parameters

bulk_id

string<uuid>

required

Bulk submission ID returned by POST /v1/radars/bulk

Response

Bulk status retrieved successfully

status

enum<string>

required

Available options:

processing,

completed

code

enum<integer>

required

Available options:

200

message

string

required

timestamp

string<date-time>

required

bulk_id

string<uuid>

required

summary

object

required

Show child attributes

radars

object[]

required

Show child attributes

Introduction / Overview

Getting Started

Core Guides

Agentic Setup

API Reference

Bulk

Webhooks

How bulk status works

Per-item fields

Authorizations

Path Parameters

Response

​How bulk status works

​Per-item fields

Authorizations

Path Parameters

Response

How bulk status works

Per-item fields