Blackboard Logo

Check the processing status of a file

Ally processes files asynchronously. We aim to process files in near-realtime, but some delays might be present. This endpoint can be used to poll for status updates.

Endpoint

GET /api/v2/clients/:clientId/content/:contentHash/status

Path Parameters

Body Parameters

Query Parameters

Expected response

This endpoint will always return a 200 status code for existing content hashes regardless of whether the file was processed successfully.

{
  "hash": "MS4gQWxsI...",
  "status": "success",
  "statusUrl": "/api/v2/clients/:clientId/content/MS4gQWxsIH.../status",
  "resourceUrl": "/api/v2/clients/:clientId/content/MS4gQWxsIH..."
}
Parameter Definition
hash the content hash used to reference the file by Ally as a Service
status the stage of processing the file is in*
statusUrl the endpoint to call to check the status
resourceUrl the endpoint to retrieve the report or metadata

The following status values can be identified:

Testing with cURL

curl \
  -H "Authorization: Bearer myJwtToken" \
  https://prod.ally.ac/api/v2/clients/:clientId/content/:contentHash/status