GET /data/v1/async/{requestId}/status

Retrieve the status of the originally posted asynchronous request. Use the status to determine if the request has completed and whether or not there were errors in processing.

URL Parameters

NameTypeDescription
requestIdstringRequiredThe requestId returned from a previous and successfully submitted asynchronous request, in this case /data/v1/async/dataextensions/*.

Responses

StatusNameTypeDescription
200  OK
 statusobjectInformation about the status of the asynchronous request.
 status.callDateTimedatetimeThe date and time the asychronous request was received.
 status.completionDateTimedatetimeThe date and time the asychronous request completed processing.
 status.pickupDateTimedatetimeThe date and time the asychronous request was picked up for processing.
 status.hasErrorsbooleanIndicates whether the results from processing the request contain any errors.
 status.requestStatusstringIndicates the status of the asychronous request itself (Pending, Completed, Error).
 status.resultStatusstringIndicates the overall status of the result from processing the request.
 status.requestIdguidThe unique identifier of the request for which this status has been retrieved.
 requestIdguidThe unique identifier of this request.

Example Request

Example Response

A successfully queued request returns the RequestId. Once the request is no longer pending, use this requestId in subsequent operations to determine the status of the asynchronous call and overall results of the persist operation.

Possible values for requestStatus are:

  • Pending
  • Complete
  • Error

Example Error Response