Get All RMAs

Updated 4 days ago ​by nussi

Overview

In order to get information for many RMAs in a single request, then you can consume the endpoint presented in this article. In order to do that, you must:

  • Be authenticated user

For information on how you can authenticate, see: Authentication

As soon as you do authentication and receive a valid token, it needs to be passed to the call for getting RMAs.

  • You can provide page number and page size and some filtering information

Endpoint

Example for such endpoint for TT server:

https://tt.api.sellercloud.com/rest/api/Rma

For your server endpoint will be:

​https://{your_server_id}.api.sellercloud.com/rest/api/Rma

Request

Information about expected request parameters can be found on swagger UI https://tt/api.sellercloud.com/rest/swagger.

  • Method Type: HttpGet
  • Authorization: Use Bearer Token (where 'Token' is the token received from the token authentication)
  • Header info: Content-Type: application/json
  • Parameters:

Parameters

Data Type

Description

Is Required

rMAIDs

List<integer>

List of RMA IDs

No

orderIDs

List<integer>

List of Order IDs related to RMAs

No

companyIDList

List<integer>

List of Company IDs to which the RMAs belong

No

productID

List<string>

List of ProductIDs in the RMAs

no

rmaStatuses

List<string>

Key values of RMA Status enumeration (see the enum definition in the enumerations documentation in the link in the end of this document)

No

orderSources

List<string>

Key values of Channels enumeration (see the enum definition in the enumerations documentation in the link in the end of this document)

No

orderSourceRMAID

string

Order Source (Channel) RMA ID

No

orderSourceOrderIDs

List<string>

List of Order Source (Channel) Order IDs

No

dateFrom

DateTime

RMA Date Create From

No

dateTo

DateTime

RMA Date Create To

No

pageNumber

integer

Number of page

No

pageSize

integer

Number of orders per page

No

Response

  • If user is authenticated, then response will be Status Code 200 => OK and RMAs metadata in JSON format
  • If user is not authenticated, then response will be Status Code 401 => Not Valid Token
  • In case of error, the response will be Status Code 500 => Internal Server Error

Response Body Format

{
  "Items": [
    {
      "CustomerID": 0,
      "FirstName": "string",
      "LastName": "string",
      "CustomerFirstName": "string",
      "CustomerLastName": "string",
      "UserID": 0,
      "CreatedOn": "2020-02-13T09:20:52.012Z",
      "ClosedOn": "2020-02-13T09:20:52.012Z",
      "ReceivedOn": "2020-02-13T09:20:52.012Z",
      "CreatedBy": "string",
      "RMAStatusCode": 0,
      "OrderSource": 0,
      "OrderSourceRMAID": "string",
      "Reason": 0,
      "ReceivedStatus": 0,
      "Resolution": 0,
      "TotalRefunded": 0,
      "Company": "string",
      "CompanyID": 0,
      "Exported": 0,
      "Items": [
        {
          "ID": 0,
          "RMAID": 0,
          "OrderID": 0,
          "SKU": "string",
          "RMANoteContains": "string",
          "SerialNumber": "string",
          "Reason": 0,
          "ReasonName": "string",
          "Resolution": 0,
          "ReceivedStatus": "string",
          "RefundStatus": 0,
          "RefundStatusName": "string",
          "OrderSubType": 0,
          "OrderSubtypeName": "string",
          "OrderSourceOrderID": "string",
          "OrderSource": 0,
          "EnabledOnChannels": [
            0
          ],
          "Company": "string",
          "CompanyID": 0,
          "ReturnedOn": "2020-02-13T09:20:52.012Z",
          "QtyReturned": 0,
          "QtyReceived": 0
        }
      ],
      "ID": 0
    }
  ],
  "TotalResults": 0
}

Documentation for the enumerations can be found here: https://developer.sellercloud.com/category/pqa1htn09q-resources

How did we do?