API Reference | ReDoc

Returns

Product Info

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.

Business Values

  • 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.

How does it work once I am setup as a user?

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.

FAQs

  • 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 returnRequestId is 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.

Error Codes

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.

  1. Without warnings - Indicates the request has been processed as anticipated.
  2. 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.

/requests/{return_request_id}

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

/requests/list

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.

SecurityOAuth2ClientCredentials
Request
path Parameters
version
required
string
Default: "v1"

version

Value: "v1"
return_request_id
required
string

The unique identifier of the return, provided at the time of its creation

Responses
200

Request was successful

401

Unauthorized

404

Resource was not found

500

Internal server error

get/returns/{version}/requests/{return_request_id}
Request samples
Response samples
application/json
{
  • "id": "67038a29b15cd352cb984261",
  • "createdAt": "2024-10-07T07:13:45.034Z",
  • "rmaId": "1728285224896",
  • "status": "ACCEPTED",
  • "groupId": null,
  • "returnReason": {
    },
  • "returnMethod": {
    },
  • "refundMode": {
    },
  • "tenantId": "dhavalbusiness",
  • "brandExternalId": "dhavalbusiness",
  • "customerAddress": {
    },
  • "itemList": [
    ],
  • "customer": {
    },
  • "orderIdBeingReturned": [
    ],
  • "orderBeingReturned": [
    ],
  • "fee": 10.02,
  • "locationExternalId": "dhavalbusiness",
  • "lastUpdatedAt": "2024-10-07T07:13:49.324Z",
  • "returnOrder": {},
  • "cancelRequestBy": "Fahad",
  • "pickupInstructions": "Pickup Window Instructions",
  • "deliveryTime": {
    },
  • "pickupTime": {
    },
  • "subStatus": null
}