curl --request GET \
--url https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn \
--header 'X-Authorization: <api-key>'import requests
url = "https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn"
headers = {"X-Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Authorization': '<api-key>'}};
fetch('https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn', 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/2026-10/warehouse/reporting/asn",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn")
.header("X-Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 17,
"return_line_item_id": "36",
"order_id": "2685651685584",
"order_name": "#1138",
"order_number": "138",
"provider_order_number": "1138",
"state": "open",
"customer_email": "h.testman@loopreturns.com",
"title": "Mens Large Hydrostatic Inflatable PFD",
"purchase_price": "199.99",
"sku": "ad-alias-corporis-cum-ut-facilis-sed-non",
"barcode": "789765484987",
"carrier": "USPS",
"service": "Parcel Select",
"label_status": "out_for_delivery",
"tracking_number": "9999999999999999999999",
"integration_tracking_url": "N/A",
"restock_status": "restocked",
"currency": "USD",
"label_updated_at": "2023-08-21T14:09:17.000Z",
"label_url": "https://test-bucket.s3-us-west-2.amazonaws.com/files/postage_label/01234567/0df7eea6147b44b7ac204e9eb8293cfa.pdf",
"label_rate": "250",
"closed_at": "2023-09-01T14:00:41.000Z",
"updated_at": "2023-08-21T14:06:32.000Z",
"created_at": "2023-08-21T14:05:56.000Z",
"return_reason": "Size was too small",
"actioned_by": "N/A",
"return_method": "happy-returns",
"return_method_rma_code": "HR01234",
"return_method_state": "in_transit",
"date_delivered": "N/A",
"outcome": "exchange",
"scannable_id": "N/A",
"package_reference": "9999999999999999999999",
"shipping_box_barcode": "N/A",
"provider_created_at": "2021-01-01T10:00:00.000Z",
"destination_id": "17",
"destination_name": "Maine Warehouse",
"destination_address1": "55 Maine Street",
"destination_address2": "Unit 3",
"destination_city": "Portland",
"destination_state": "Maine",
"destination_zip": "54321",
"consolidation_tracking": "<string>"
}
]Advanced Shipping Notice
This endpoint will pull all packages by tracking statuses/timeframe. The ASN endpoint will return an array of objects. Those objects will contain order and return information.
Version Note (2026-10+): from and to must be parseable dates, and the range between them
must not exceed 120 days (a range of exactly 120 days is allowed). Requests that break either
rule return HTTP 422 with a validation error on both from and to. Earlier versions accept
any range and fall back to the Unix epoch for unparseable values.
Required API key scope
- Returns
curl --request GET \
--url https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn \
--header 'X-Authorization: <api-key>'import requests
url = "https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn"
headers = {"X-Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Authorization': '<api-key>'}};
fetch('https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn', 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/2026-10/warehouse/reporting/asn",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn")
.header("X-Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.loopreturns.com/api/2026-10/warehouse/reporting/asn")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 17,
"return_line_item_id": "36",
"order_id": "2685651685584",
"order_name": "#1138",
"order_number": "138",
"provider_order_number": "1138",
"state": "open",
"customer_email": "h.testman@loopreturns.com",
"title": "Mens Large Hydrostatic Inflatable PFD",
"purchase_price": "199.99",
"sku": "ad-alias-corporis-cum-ut-facilis-sed-non",
"barcode": "789765484987",
"carrier": "USPS",
"service": "Parcel Select",
"label_status": "out_for_delivery",
"tracking_number": "9999999999999999999999",
"integration_tracking_url": "N/A",
"restock_status": "restocked",
"currency": "USD",
"label_updated_at": "2023-08-21T14:09:17.000Z",
"label_url": "https://test-bucket.s3-us-west-2.amazonaws.com/files/postage_label/01234567/0df7eea6147b44b7ac204e9eb8293cfa.pdf",
"label_rate": "250",
"closed_at": "2023-09-01T14:00:41.000Z",
"updated_at": "2023-08-21T14:06:32.000Z",
"created_at": "2023-08-21T14:05:56.000Z",
"return_reason": "Size was too small",
"actioned_by": "N/A",
"return_method": "happy-returns",
"return_method_rma_code": "HR01234",
"return_method_state": "in_transit",
"date_delivered": "N/A",
"outcome": "exchange",
"scannable_id": "N/A",
"package_reference": "9999999999999999999999",
"shipping_box_barcode": "N/A",
"provider_created_at": "2021-01-01T10:00:00.000Z",
"destination_id": "17",
"destination_name": "Maine Warehouse",
"destination_address1": "55 Maine Street",
"destination_address2": "Unit 3",
"destination_city": "Portland",
"destination_state": "Maine",
"destination_zip": "54321",
"consolidation_tracking": "<string>"
}
]Query Parameters
The start of the date range. If omitted, defaults to one week ago at the start of the day.
Before API version 2026-10, invalid values fall back to the Unix epoch.
In API version 2026-10 and later, an unparseable value returns 422, and the range from
from to to must not exceed 120 days.
"2023-08-21T00:00:00.000Z"
The end of the date range. If omitted, defaults to the end of the current day.
Before API version 2026-10, invalid values fall back to the Unix epoch.
In API version 2026-10 and later, an unparseable value returns 422, and the range from
from to to must not exceed 120 days.
"2023-08-21T00:00:00.000Z"
Response
Success