Get Validation Results

Retrieve results of an async validation job

POST /api/validate_stream_result

Get Validation Results

cURL

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

Processing

{
  "job_id": "abc123def456",
  "status": "processing",
  "started": "2026-01-08T10:30:00Z",
  "timestamp": "2026-01-08T10:30:15Z"
}

Retrieve results of an asynchronous validation job. Poll this endpoint until status is done or failed.

Request Body

job_id · string · required

Job ID to retrieve results for

Response

job_id · string

Unique identifier for the validation job

status · string

Job status: pending, processing, done, or failed

started · string

ISO 8601 timestamp when processing started

timestamp · string

ISO 8601 timestamp of current status

overall_status · string

Overall validation result (when done): issues_found, passed, etc.

summary · object

Summary of validation checks

Show summary properties

total_checks · integer

Total number of checks performed

passed · integer

Number of passed checks

failed · integer

Number of failed checks

warnings · integer

Number of warnings

fixes · array

Array of identified issues with recommendations

fixes_group · object

Issues grouped by category

metadata · object

Processing metadata

error · string

Error message (when status is failed)

Job Status Values

Status	Description
pending	Job created, waiting to start
processing	Validation in progress
done	Validation completed successfully
failed	Validation failed with error

Processing

{
  "job_id": "abc123def456",
  "status": "processing",
  "started": "2026-01-08T10:30:00Z",
  "timestamp": "2026-01-08T10:30:15Z"
}

Example

cURL

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