Skip to main content
POST
/
api
/
validate_stream_start
Start Validation
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": {}
}
'
{
  "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
{
  "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

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

​
Example

curl -X POST "https://zhshgjat2b.execute-api.us-east-1.amazonaws.com/dev/v1/api/validate_stream_start/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "abc123def456"
  }'