Retrieve the status of a return

GET {{baseUrl}}/brand/:brand_domain/return-portal/label/polling?token=<string>

Once a return parcel is successfully created, a polling URL is included in the response. Creating a label depends on the response time of the carrier, so you need to make a request to this endpoint to see the status of the label. The URL you received contains a token with the id, so you don’t need to provide any additional lookup details or authentication.

  • A 200 response will indicate that the label is ready and can be downloaded.
  • A 202 response will indicate that the label is not ready to be downloaded but the return data has been accepted. If you have paid returns enabled this status is used to indicate we are waiting for payment. For more information take a look at this help center article.
  • A 500 response means that the label announcement failed.

Request Params

KeyDatatypeRequiredDescription
tokenstringPolling token, used to find the return

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;download_url&quot;:&quot;\u003curi\u003e&quot;,&quot;return&quot;:&quot;\u003cinteger\u003e&quot;,&quot;parcels&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;tracking_numbers&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;customs_declaration_url&quot;:&quot;\u003curi\u003e&quot;}