The Returns API enables customers to retrieve details of an existing return order. Designed to streamline the returns process, it allows businesses to access essential return order data seamlessly.
Efficient Returns Retrieval: - Access comprehensive return order details in real-time, enabling seamless tracking and management of the returns process.
Integration Flexibility: - Enhance operational workflows by integrating return order retrieval functionality directly into your platform, ensuring consistency and ease of access.
Once set up as a user, you can retrieve details of an existing return order via the Returns API.
Simply use the Get Return Request by ID endpoint to fetch information for a specific return
request initiated through the returns portal.
How are return orders initiated?
Return orders are initiated through our returns portal based on an existing order. They cannot be created directly via the API.
What details can I retrieve using the Returns API?
The API provides comprehensive details about an existing return order, including return status, associated order information, and customer details.
How is the returnRequestId generated?
The
returnRequestIdis generated during the creation of a return request in the returns portal and shared via a webhook. It serves as the unique identifier for the return order in subsequent API calls.
When the system is unable to respond to a request, be it from a malformed request, an illegal or invalid value, or other issues, the API generates an error response.
Successful response may or may not include warnings.
- Without warnings - Indicates the request has been processed as anticipated.
- With warnings - Indicates the request has been processed with potentially unanticipated results. The warning contains information in the response that should be passed to the end user.
The severity of an error may be transient or hard.
- Transient error - Indicates an error that is temporary in nature. Such errors may be caused by response timeouts due to high server loads or scheduled maintenance in progress. The request may be issued successfully at a later time.
- Hard error - Indicates the request has a problem that the system is not able to resolve. These errors are critical and prevent requests from processing.
GET
| Type | HTTP Code | Severity | Description |
|---|---|---|---|
| UNAUTHORIZED | 401 | Hard | Unauthorized: Invalid or missing authentication token |
| INTERNAL_SERVER_ERROR | 500 | Transient | Internal Server Error: An unexpected error occurred while processing the request |
| INVALID_DATA | 422 | Hard | Bad Request: brandExternalId is invalid |
| NOT_FOUND | 404 | Hard | Not Found: Return request not found |
POST
| Type | HTTP Code | Severity | Description |
|---|---|---|---|
| UNAUTHORIZED | 401 | Hard | Unauthorized: Invalid or missing authentication token |
| INTERNAL_SERVER_ERROR | 500 | Transient | Internal Server Error: An unexpected error occurred while processing the request |
| INVALID_DATA | 422 | Hard | Bad Request: brandExternalId is invalid |
Retrieve Return Details
Retrieve the details of a specific return by its unique identifier.
Request was successful
Unauthorized
Resource was not found
Internal server error
- curl
- Node.js
- JavaScript
- PHP
- Python
- C#
- Java
- 200
- 401
- 404
- 500
{- "id": "67038a29b15cd352cb984261",
- "createdAt": "2024-10-07T07:13:45.034Z",
- "rmaId": "1728285224896",
- "status": "ACCEPTED",
- "groupId": null,
- "returnReason": {
- "code": "DHA01",
- "name": "Don't want the product anymore",
- "type": "others"
}, - "returnMethod": {
- "code": "DHARM03",
- "name": "Drop it off - No Label Needed",
- "type": "ship-it-back-qr-code",
- "displayName": "Drop it off - No Label Needed"
}, - "refundMode": {
- "code": "DHARFM01",
- "name": "Cash"
}, - "tenantId": "dhavalbusiness",
- "brandExternalId": "dhavalbusiness",
- "customerAddress": {
- "street1": "4147 Moselle Road",
- "city": "Islandton",
- "state": "SC",
- "postalCode": "29929",
- "countryCode": "US",
- "latitude": 32.9423294,
- "longitude": -81.0004286
}, - "itemList": [
- {
- "sku": "sku22",
- "quantity": 1,
- "size": {
- "length": 0.01,
- "width": 0.01,
- "height": 0.01,
- "unit": "in"
}, - "weight": {
- "value": 7,
- "unit": "lb"
}, - "price": 1108,
- "salePrice": 1008,
- "title": "Green Shade Rayban Sunglasses",
- "description": "Sunglasses",
- "itemAttributes": {
- "size": "S",
- "color": "green",
- "style": "abstract",
- "material": "linen"
}, - "tags": [ ],
- "refId": "b3JkZXJxYTEwX19za3UyMl9fNw=="
}
], - "customer": {
- "email": "dhaval.parmar@deliverysolutions.co",
- "phone": "+12015554312",
- "name": "Dhaval Parmar",
- "userExternalId": "test1"
}, - "orderIdBeingReturned": [
- "6647528f6a63444b45da7492"
], - "orderBeingReturned": [
- "orderqa10"
], - "fee": 10.02,
- "locationExternalId": "dhavalbusiness",
- "lastUpdatedAt": "2024-10-07T07:13:49.324Z",
- "returnOrder": {
- "order": "67038a29a0a8f0e0a8cd88e1",
- "providerInfo": {
- "providerId": "",
- "name": "UPS",
- "displayName": ""
}, - "amount": 15.85,
- "trackingId": "1ZXXXXXXXXXXXXXXXX",
- "referenceLinks": {
}, - "orderExternalId": "orderqa10-1728285224896",
- "requestedTime": null,
- "shipments": [
]
}, - "cancelRequestBy": "Fahad",
- "pickupInstructions": "Pickup Window Instructions",
- "deliveryTime": {
- "endsAt": 1738591200000
}, - "pickupTime": {
- "startsAt": 1738580400000,
- "endsAt": 1738591200000
}, - "subStatus": null
}