Check for Request Status

Overview Endpoint Reference Responses

Overview

The GET /api/reporting/data-extract/{requestId} endpoint retrieves the current status of a previously submitted assessment data extraction job. When the job completes successfully, the response includes one or more pre-signed download URLs for the output file.

What you can do

✓Check the status of a submitted extraction job using its requestId

✓Retrieve download URLs for the output file when the job status is OK

Prerequisites

✓A valid OAuth 2.0 bearer token

✓A requestId returned from a prior POST /api/reporting/data-extract call

Endpoint Reference

Method

GET

URL

https://api.trustarc.com/api/reporting/data-extract/{requestId}

URL Parameters

Required Path Parameters

Name	Value	Description
requestId	UUID	The unique identifier of the extraction job, returned by the POST /api/reporting/data-extract request.

Sample Request with curl

curl -X GET \
  -H "authorization: Bearer <token>" \
  'https://api.trustarc.com/api/reporting/data-extract/a7628360-27a7-4ef0-8ade-ddba9650d60e'

Responses

Success Response

Code: 200 OK

{
  "url": [
    "https://themis-prod.s3.amazonaws.com/themis/account/..."
  ],
  "requestId": "a7628360-27a7-4ef0-8ade-ddba9650d60e",
  "requestSequence": 20,
  "status": "OK",
  "message": "Total 1179 record(s) in 1 file(s)"
}

Error Responses

Code: 400 Bad Request

Code: 401 Unauthorized

TrustArc  ·  Assessment Data Extraction API — GET /api/reporting/data-extract/{requestId}  ·  support.trustarc.com