Skip to main content
POST
/
v1
/
radars
/
bulk
Submit an async bulk radar request
curl --request POST \
  --url https://api.tamradar.com/v1/radars/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "webhook_url": "https://your-domain.com/webhooks/tamradar",
  "radars": [
    {
      "domain": "stripe.com",
      "radar_type": "company_job_openings",
      "departments": [
        "Engineering"
      ],
      "custom_fields": {
        "crm_account_id": "acc_001"
      }
    },
    {
      "domain": "stripe.com",
      "radar_type": "contact_job_changes",
      "profile_url": "https://www.linkedin.com/in/janedoe",
      "custom_fields": {
        "contact_id": "con_001"
      }
    },
    {
      "radar_type": "industry_mentions",
      "keyword": "zero trust security",
      "countries": [
        "US"
      ]
    }
  ]
}
'
{
  "status": "success",
  "code": 202,
  "message": "Bulk submission accepted — radars are being created asynchronously",
  "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
  "summary": {
    "total": 3
  },
  "timestamp": "2026-05-24T18:22:01.000Z"
}
The bulk_completed webhook carries the full per-item result array. At 1,000 items with rich custom_fields or filter data, the payload can approach 1–2 MB — ensure your receiver can handle it. Alternatively, use GET /v1/radars/bulk/{bulk_id} to fetch results on demand.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
webhook_url
string<uri>
required

Webhook endpoint that receives async item results and the final bulk_completed event.

Maximum string length: 2048
Example:

"https://your-domain.com/webhooks/tamradar"

​
radars
object[]
required

Array of radar payloads. Each item uses the same body structure as single radar creation (POST /v1/radars): include radar_type plus the matching fields for that radar (for example domain/profile_url/keyword, filters, custom_fields). Item-level validation runs asynchronously after the request is accepted.

Required array length: 1 - 1000 elements

Response

Bulk submission accepted and queued for async processing

​
status
enum<string>
required
Available options:
success
​
code
enum<integer>
required
Available options:
202
​
message
string
required
​
bulk_id
string<uuid>
required
​
summary
object
required
​
timestamp
string<date-time>
required