Start Validation

Trigger validation after S3 upload

POST /api/validate_stream_start

Start Validation

cURL

curl --request POST \
  --url https://api.example.com/api/validate_stream_start/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_id": "<string>",
  "document_category": "<string>",
  "document_metadata": {}
}
'

202 Accepted

{
  "job_id": "abc123def456",
  "status": "accepted",
  "message": "Validation request queued for processing",
  "timestamp": "2026-01-08T10:30:00Z",
  "document_size": 1048576,
  "next_steps": {
    "poll_results": "POST /api/validate_stream_result/ with {\"job_id\": \"abc123def456\"}"
  }
}

Trigger validation after uploading a document via presigned URL.

Request Body

job_id · string · required

Job ID from the presigned URL response

document_category · string

Override document category from presigned URL request

document_metadata · object

Override document metadata from presigned URL request

Response

job_id · string

Unique identifier for the validation job

status · string

Job status: accepted

message · string

Status message

timestamp · string

ISO 8601 timestamp

document_size · integer

Size of the uploaded document in bytes

next_steps · object

Instructions for retrieving results

202 Accepted

{
  "job_id": "abc123def456",
  "status": "accepted",
  "message": "Validation request queued for processing",
  "timestamp": "2026-01-08T10:30:00Z",
  "document_size": 1048576,
  "next_steps": {
    "poll_results": "POST /api/validate_stream_result/ with {\"job_id\": \"abc123def456\"}"
  }
}

Error Responses

Status	Description
400	Missing job_id or document_category/metadata
404	Document not found in S3
409	Job already started or completed

Example

cURL

curl -X POST "https://{api-url}/api/validate_stream_start/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "abc123def456"
  }'