Admin API
Conditions
List all returns
Get a list of returns, their details and items, given parameters. Used by merchants to list registered returns to start, or check if an item already exists in a return.
curl --request GET \
--url https://app.supercycle.com/api/v1/return_orders \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"id": 123,
"createdAt": "2023-11-07T05:31:56Z",
"creditStatus": "uncredited",
"customer": {
"id": 123,
"createdAt": "2023-11-07T05:31:56Z",
"defaultAddress": null,
"email": null,
"firstName": null,
"lastName": null,
"shopifyId": 123
},
"returnLines": [
{
"id": 123,
"createdAt": "2023-11-07T05:31:56Z",
"condition": null,
"rentalId": 123,
"requestedAt": null,
"restockedAt": null,
"status": "awaiting"
}
],
"requestedAt": null,
"sequentialId": 123,
"status": "requested"
}
],
"nextPage": null
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 50.
x < 100
Cursor token to fetch next page of results.
Response
Numeric ID of the return.
uncredited
, partially_recredited
, recredited
Numeric ID of the customer.
Default address of the customer.
Numeric ID of the customer.
Numeric ID of the return line.
Status of the return line.
awaiting
, received
, missing
Numeric ID of the condition.
Date and time the condition was created.
Severity key of the condition.
Tone of the condition.
Title of the condition.
Sequential ID of the return.
Status of the return.
requested
, expected
, received
, in_progress
, completed
, cancelled
curl --request GET \
--url https://app.supercycle.com/api/v1/return_orders \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"id": 123,
"createdAt": "2023-11-07T05:31:56Z",
"creditStatus": "uncredited",
"customer": {
"id": 123,
"createdAt": "2023-11-07T05:31:56Z",
"defaultAddress": null,
"email": null,
"firstName": null,
"lastName": null,
"shopifyId": 123
},
"returnLines": [
{
"id": 123,
"createdAt": "2023-11-07T05:31:56Z",
"condition": null,
"rentalId": 123,
"requestedAt": null,
"restockedAt": null,
"status": "awaiting"
}
],
"requestedAt": null,
"sequentialId": 123,
"status": "requested"
}
],
"nextPage": null
}