DocumentationAPI referenceDownload batch results

SATIK API · V1 BETA

Download batch results

Authenticated CSV for completed or cancelled batches. Includes every row with status; cancelled rows have no verification result. Retained for seven days after submission.

GET

https://api.satik.in/v1/batches/{batch_id}/download

Use a server-side Bearer API key. Authentication guide →

Parameters

Endpoint parameters
ParameterRequirement and type
Batch idbatch_idRequired · path parameter · string.
Full parameter schema
[
  {
    "name": "batch_id",
    "in": "path",
    "required": true,
    "schema": {
      "type": "string"
    }
  }
]

Sample request (cURL)

Set the Postman variable SATIK_LIVE_KEY to a live key from your workspace.

curl --request GET 'https://api.satik.in/v1/batches/{{BATCH_ID}}/download' \
  --header 'Authorization: Bearer {{SATIK_LIVE_KEY}}'

Downloads authenticated CSV results for a completed or cancelled workspace batch. Cancelled rows have status cancelled and no verification result. Available for seven days after submission. Save the response as a CSV file in Postman.

In Postman, choose Import and paste this cURL command. These double-brace variables are resolved by Postman; for a terminal request, replace them with actual values. For local testing, replace https://api.satik.in/v1 with http://localhost:3001/api/v1, keeping the endpoint path.

Responses and errors

HTTP 200
{
  "description": "CSV results",
  "content": {
    "text/csv": {
      "schema": {
        "type": "string"
      }
    }
  }
}
HTTP 401
{
  "description": "Authentication failed"
}
HTTP 404
{
  "description": "Batch not found in this workspace"
}
HTTP 409
{
  "description": "Batch still active"
}
HTTP 410
{
  "description": "Results expired"
}

View shared schemas →