GET /data/v1/async/{requestId}/status
Retrieve the status of a request to insert or upsert rows in a data extension. The response tells you if the request is complete and whether there were errors in processing it.
Name | Type | Description | |
---|---|---|---|
requestId | string | Required | The requestId provided by a previously submitted asynchronous insert or update request. |
Status | Name | Type | Description |
---|---|---|---|
200 | OK | ||
status | object | Information about the status of the asynchronous request. | |
status.callDateTime | datetime | The date and time the asynchronous request was received. | |
status.completionDateTime | datetime | The date and time the asynchronous request completed processing. | |
status.pickupDateTime | datetime | The date and time the asynchronous request was picked up for processing. | |
status.hasErrors | boolean | Indicates whether the results from processing the request contain any errors. | |
status.requestStatus | string | The status of the asynchronous request, such as Pending , Completed , or Error . | |
status.resultStatus | string | The status of the request. | |
status.requestId | guid | The unique identifier of the request to insert or upsert data rows. | |
requestId | guid | The unique identifier of the request to retrieve the status of the request. |
A successfully queued request returns the RequestId. When 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