---
title: "Start a SAM bulk scan"
method: POST
path: "/api/import/startSamBulkScan"
tags: ["import"]
---

# Start a SAM bulk scan

`POST /api/import/startSamBulkScan`

Triggers a SAM bulk scan import operation. This endpoint is feature-gated and only available when BulkScanEndpointsEnabled is true. Returns 409 if a scan is already running.

## Response `202`

Accepted - Scan started successfully

- StartScanResponse — Response returned when a scan is successfully started.
  - `scanCorrelationId` string, uuid — A unique correlation ID for tracking the scan operation.
  - `message` string — A human-readable message about the scan status.
  - `startedAt` string, date-time, nullable — The UTC timestamp when the scan was started.

## Other responses

- `409` — Conflict - A scan is already running

---

[API](https://skmtc.dev/defra/apis/livestock-keeper-data-api-internal.md) · [All operations](https://skmtc.dev/defra/apis/livestock-keeper-data-api-internal/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/defra/livestock-keeper-data-api-internal/revisions/bfd8eb077a9b/schema)