Provide an interim status update for a regulated order

Learn how to provide an interim status update for a regulated order while it's under review.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
• The Direct-to-Consumer Shipping (Restricted) role assigned to your developer profile.
• The Direct-to-Consumer Shipping (Restricted) role selected in the app registration page for your application.

Provide an interim status update

Call the updateVerificationStatus operation with status set to Pending. Include a valid status code to interimStatusDetail within the verificationDetails object.

📘

Note

The interimStatusDetail verification detail type is only supported when status is set to Pending. Using it with Approved or Rejected returns an InvalidInput error.

Valid interimStatusDetail status codes

Example request body

The following example provides an interim status update indicating the vet was contacted through email:

{
  "regulatedOrderVerificationStatus": {
    "status": "Pending",
    "externalReviewerId": "vetsource_system",
    "verificationDetails": {
      "interimStatusDetail": {
        "statusCode": "vet_contacted_email",
        "statusDateTime": "2026-02-26T10:00:00Z"
      }
    }
  }
}