List an invoice's return merchandise authorisations

Returns one page of the return merchandise authorisations raised against an invoice.

GET /invoices/{invoice_id}/return_merchandise_authorisations

cURL

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/invoices/INV-0001/return_merchandise_authorisations?limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

200

{
  "data": [
    {
      "account": {
        "code": "<string>",
        "href": "<string>",
        "id": "<string>",
        "name": "<string>",
        "object": "<string>"
      },
      "code": "<string>",
      "created_by": {
        "name": "<string>",
        "object": "<string>"
      },
      "created_on": "<string>",
      "href": "<string>",
      "id": "<string>",
      "item_count": 123,
      "last_updated_by": "<unknown>",
      "last_updated_on": "<unknown>",
      "note": "<string>",
      "object": "<string>",
      "return_status": "<string>",
      "rma_date": "<string>",
      "sale_invoice": {
        "code": "<string>",
        "href": "<string>",
        "id": "<string>",
        "object": "<string>"
      },
      "sale_order": "<unknown>",
      "status": "<string>",
      "version": 123,
      "warehouse": "<unknown>"
    }
  ],
  "object": "<string>",
  "pagination": {
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "links": {
      "next": "<string>",
      "prev": "<string>"
    }
  },
  "url": "<string>"
}

Lists the invoice’s return merchandise authorisations, one page at a time, under data. The path uses the British spelling authorisations; the spelling with a z returns 404.

The SDK samples get their client from credentials your app registers once when it starts, as shown in Authentication. To try the call here, click Try it, set host to your Exsited API host name and paste an access token from Get an access token.

Authorizations

Authorization · string · header · required

An access token from POST /api/v4/oauth2/token. The SDKs get and renew it for you.

Path Parameters

invoice_id · string · required

The invoice's id, such as INV-0001. Not its uuid.

Query Parameters

limit · integer

The most records to return on one page.

Example:

20

cursor · string

The next_cursor value from the previous page, to fetch the page after it.

sort · string

The field to sort by. Put - in front for descending order, such as -created_on.

Example:

"-created_on"

Response

200 - application/json

One page of return merchandise authorisations, under data, with pagination.

data · object[]

Show child attributes

object · string

pagination · object

Show child attributes

url · string