The Salesforce Developers website will undergo maintenance on May 29, 2024 from 3:00 a.m. UTC to 10:00 a.m. UTC. The maintenance process may affect the availability of our documentation. Please plan accordingly.

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.

NameTypeDescription
requestIdstringRequiredThe requestId provided by a previously submitted asynchronous insert or update request.
StatusNameTypeDescription
200  OK
 statusobjectInformation about the status of the asynchronous request.
 status.callDateTimedatetimeThe date and time the asynchronous request was received.
 status.completionDateTimedatetimeThe date and time the asynchronous request completed processing.
 status.pickupDateTimedatetimeThe date and time the asynchronous request was picked up for processing.
 status.hasErrorsbooleanIndicates whether the results from processing the request contain any errors.
 status.requestStatusstringThe status of the asynchronous request, such as Pending, Completed, or Error.
 status.resultStatusstringThe status of the request.
 status.requestIdguidThe unique identifier of the request to insert or upsert data rows.
 requestIdguidThe 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