List batch migrations
List the batch migrations of your organization. A batch migration groups detection rules from another SIEM that the Datadog Detection Agent translates into Cloud SIEM detection rules. To retrieve a single batch migration, filter by its ID with filter[query]=id:<batch_id>. Poll this endpoint to follow the progress of a batch migration through its status and resourceStatusCounts.
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopessecurity_monitoring_rules_read
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Size for a given page. The maximum allowed value is 500.
Specific page number to return, starting at 1.
A search query in Datadog search syntax to filter batch migrations, such as status:completed. Filterable attributes are id, name, description, status, createdBy, and lastUpdatedBy. Free text matches the batch migration name.
Response
OK
Example response
{
"data": [
{
"attributes": {
"createdAt": "2026-09-21T12:00:00Z",
"createdBy": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
"description": "Rules imported from Splunk",
"inputSource": "batch_migration",
"lastUpdatedAt": "2026-09-21T12:00:00Z",
"lastUpdatedBy": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
"name": "Splunk migration",
"orgId": 123456,
"resourceStatusCounts": {
"pending": 1
},
"status": "draft",
"tags": [
"source:splunk"
]
},
"id": "7cdb3a75-64fb-46ce-9445-41969e78fe8e",
"type": "batchMigration"
}
],
"meta": {
"totalCount": 1
}
}Changes
Changes to this operation have not been checked yet.