curl --request POST \
--url https://api.loopreturns.com/api/v1/dispositioning/grade \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"items": [
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": {
"subject": "<string>",
"title": "<string>",
"grade": "<string>",
"category_name": "<string>",
"category_parent": "<string>"
},
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31T23:59:59+00:00"
}
]
}
'import requests
url = "https://api.loopreturns.com/api/v1/dispositioning/grade"
payload = { "items": [
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": {
"subject": "<string>",
"title": "<string>",
"grade": "<string>",
"category_name": "<string>",
"category_parent": "<string>"
},
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.
",
"images": ["https://example.com/image.jpg"],
"inspected_at": "2024-03-31T23:59:59+00:00"
}
] }
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
line_item_id: 1,
description: 'Grade A: No refurbishment needed',
condition_category: {
subject: '<string>',
title: '<string>',
grade: '<string>',
category_name: '<string>',
category_parent: '<string>'
},
return_processor: 'warehouse-operator@example.com',
note: 'This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n',
images: ['https://example.com/image.jpg'],
inspected_at: '2024-03-31T23:59:59+00:00'
}
]
})
};
fetch('https://api.loopreturns.com/api/v1/dispositioning/grade', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.loopreturns.com/api/v1/dispositioning/grade",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'line_item_id' => 1,
'description' => 'Grade A: No refurbishment needed',
'condition_category' => [
'subject' => '<string>',
'title' => '<string>',
'grade' => '<string>',
'category_name' => '<string>',
'category_parent' => '<string>'
],
'return_processor' => 'warehouse-operator@example.com',
'note' => 'This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.
',
'images' => [
'https://example.com/image.jpg'
],
'inspected_at' => '2024-03-31T23:59:59+00:00'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.loopreturns.com/api/v1/dispositioning/grade"
payload := strings.NewReader("{\n \"items\": [\n {\n \"line_item_id\": 1,\n \"description\": \"Grade A: No refurbishment needed\",\n \"condition_category\": {\n \"subject\": \"<string>\",\n \"title\": \"<string>\",\n \"grade\": \"<string>\",\n \"category_name\": \"<string>\",\n \"category_parent\": \"<string>\"\n },\n \"return_processor\": \"warehouse-operator@example.com\",\n \"note\": \"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\\n\",\n \"images\": [\n \"https://example.com/image.jpg\"\n ],\n \"inspected_at\": \"2024-03-31T23:59:59+00:00\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.loopreturns.com/api/v1/dispositioning/grade")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"line_item_id\": 1,\n \"description\": \"Grade A: No refurbishment needed\",\n \"condition_category\": {\n \"subject\": \"<string>\",\n \"title\": \"<string>\",\n \"grade\": \"<string>\",\n \"category_name\": \"<string>\",\n \"category_parent\": \"<string>\"\n },\n \"return_processor\": \"warehouse-operator@example.com\",\n \"note\": \"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\\n\",\n \"images\": [\n \"https://example.com/image.jpg\"\n ],\n \"inspected_at\": \"2024-03-31T23:59:59+00:00\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.loopreturns.com/api/v1/dispositioning/grade")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"line_item_id\": 1,\n \"description\": \"Grade A: No refurbishment needed\",\n \"condition_category\": {\n \"subject\": \"<string>\",\n \"title\": \"<string>\",\n \"grade\": \"<string>\",\n \"category_name\": \"<string>\",\n \"category_parent\": \"<string>\"\n },\n \"return_processor\": \"warehouse-operator@example.com\",\n \"note\": \"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\\n\",\n \"images\": [\n \"https://example.com/image.jpg\"\n ],\n \"inspected_at\": \"2024-03-31T23:59:59+00:00\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": {
"subject": "<string>",
"title": "<string>",
"grade": "<string>",
"category_name": "<string>",
"category_parent": "<string>"
},
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31T23:59:59+00:00"
}
]{
"errors": "Unauthorized."
}{
"message": "This action is unauthorized."
}{
"message": "The items.0.images.0 must not be greater than 2048 characters.",
"errors": {}
}Grade Items
Grade the condition of return line items.
Required API key scope
- Returns
curl --request POST \
--url https://api.loopreturns.com/api/v1/dispositioning/grade \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"items": [
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": {
"subject": "<string>",
"title": "<string>",
"grade": "<string>",
"category_name": "<string>",
"category_parent": "<string>"
},
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31T23:59:59+00:00"
}
]
}
'import requests
url = "https://api.loopreturns.com/api/v1/dispositioning/grade"
payload = { "items": [
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": {
"subject": "<string>",
"title": "<string>",
"grade": "<string>",
"category_name": "<string>",
"category_parent": "<string>"
},
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.
",
"images": ["https://example.com/image.jpg"],
"inspected_at": "2024-03-31T23:59:59+00:00"
}
] }
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
line_item_id: 1,
description: 'Grade A: No refurbishment needed',
condition_category: {
subject: '<string>',
title: '<string>',
grade: '<string>',
category_name: '<string>',
category_parent: '<string>'
},
return_processor: 'warehouse-operator@example.com',
note: 'This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n',
images: ['https://example.com/image.jpg'],
inspected_at: '2024-03-31T23:59:59+00:00'
}
]
})
};
fetch('https://api.loopreturns.com/api/v1/dispositioning/grade', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.loopreturns.com/api/v1/dispositioning/grade",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'line_item_id' => 1,
'description' => 'Grade A: No refurbishment needed',
'condition_category' => [
'subject' => '<string>',
'title' => '<string>',
'grade' => '<string>',
'category_name' => '<string>',
'category_parent' => '<string>'
],
'return_processor' => 'warehouse-operator@example.com',
'note' => 'This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.
',
'images' => [
'https://example.com/image.jpg'
],
'inspected_at' => '2024-03-31T23:59:59+00:00'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.loopreturns.com/api/v1/dispositioning/grade"
payload := strings.NewReader("{\n \"items\": [\n {\n \"line_item_id\": 1,\n \"description\": \"Grade A: No refurbishment needed\",\n \"condition_category\": {\n \"subject\": \"<string>\",\n \"title\": \"<string>\",\n \"grade\": \"<string>\",\n \"category_name\": \"<string>\",\n \"category_parent\": \"<string>\"\n },\n \"return_processor\": \"warehouse-operator@example.com\",\n \"note\": \"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\\n\",\n \"images\": [\n \"https://example.com/image.jpg\"\n ],\n \"inspected_at\": \"2024-03-31T23:59:59+00:00\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.loopreturns.com/api/v1/dispositioning/grade")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"line_item_id\": 1,\n \"description\": \"Grade A: No refurbishment needed\",\n \"condition_category\": {\n \"subject\": \"<string>\",\n \"title\": \"<string>\",\n \"grade\": \"<string>\",\n \"category_name\": \"<string>\",\n \"category_parent\": \"<string>\"\n },\n \"return_processor\": \"warehouse-operator@example.com\",\n \"note\": \"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\\n\",\n \"images\": [\n \"https://example.com/image.jpg\"\n ],\n \"inspected_at\": \"2024-03-31T23:59:59+00:00\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.loopreturns.com/api/v1/dispositioning/grade")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"line_item_id\": 1,\n \"description\": \"Grade A: No refurbishment needed\",\n \"condition_category\": {\n \"subject\": \"<string>\",\n \"title\": \"<string>\",\n \"grade\": \"<string>\",\n \"category_name\": \"<string>\",\n \"category_parent\": \"<string>\"\n },\n \"return_processor\": \"warehouse-operator@example.com\",\n \"note\": \"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\\n\",\n \"images\": [\n \"https://example.com/image.jpg\"\n ],\n \"inspected_at\": \"2024-03-31T23:59:59+00:00\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": {
"subject": "<string>",
"title": "<string>",
"grade": "<string>",
"category_name": "<string>",
"category_parent": "<string>"
},
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31T23:59:59+00:00"
}
]{
"errors": "Unauthorized."
}{
"message": "This action is unauthorized."
}{
"message": "The items.0.images.0 must not be greater than 2048 characters.",
"errors": {}
}Authorizations
Body
An array of items to grade.
1 - 30 elementsShow child attributes
Show child attributes
Response
Success
30The unique identifier associated with the line item.
1
The description of the item's condition.
255"Grade A: No refurbishment needed"
The condition of the returned item, represented as a category object. On grade requests, subject and title are required when this object is provided; grade, category_name, and category_parent are optional.
Show child attributes
Show child attributes
The email address of the warehouse partner used to process returns.
100"warehouse-operator@example.com"
Any additional notes on the item's condition.
65535"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.\n"
An array of links to images of the item.
52048The date and time at which the item was inspected, in RFC 3339 (ISO 8601) format with a UTC offset (DATE_ATOM), e.g. 2024-03-31T23:59:59+00:00.
"2024-03-31T23:59:59+00:00"