curl --location --request GET 'https://api.stateset.com/api/v1/asns?status=in_transit&warehouse_id=wh_001&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY'
query ListASNs(
$limit: Int
$offset: Int
$status: ASNStatus
$warehouse_id: String
$expected_arrival_after: DateTime
) {
asns(
limit: $limit
offset: $offset
status: $status
warehouse_id: $warehouse_id
expected_arrival_after: $expected_arrival_after
) {
data {
id
asn_number
status
supplier {
id
name
}
warehouse {
id
name
}
expected_arrival_date
tracking_info {
carrier
tracking_number
current_status
}
item_summary {
total_items
total_quantity
}
}
has_more
total_count
}
}
const asns = await stateset.asns.list({
status: 'in_transit',
warehouse_id: 'wh_001',
expected_arrival_after: '2024-01-15T00:00:00Z',
limit: 10,
sort_by: 'expected_arrival_date',
sort_order: 'asc'
});
// Iterate through all ASNs
for await (const asn of stateset.asns.list()) {
console.log(asn.asn_number, asn.status);
}
asns = stateset.asns.list(
status='in_transit',
warehouse_id='wh_001',
expected_arrival_after='2024-01-15T00:00:00Z',
limit=10,
sort_by='expected_arrival_date',
sort_order='asc'
)
# Iterate through all ASNs
for asn in stateset.asns.list():
print(asn.asn_number, asn.status)
{
"object": "list",
"data": [
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "in_transit",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-16T08:00:00Z",
"purchase_order_id": "po_123456789",
"purchase_order_number": "PO-2024-00123",
"supplier": {
"id": "sup_abc123",
"name": "AudioTech Suppliers Inc."
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center"
},
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"current_status": "In Transit",
"last_update": "2024-01-16T08:00:00Z"
},
"item_summary": {
"total_items": 2,
"total_quantity": 1500,
"total_value": {
"amount": 4200000,
"currency": "USD"
}
}
},
{
"id": "asn_xyz789def456",
"object": "asn",
"asn_number": "ASN-2024-00002",
"status": "in_transit",
"created_at": "2024-01-16T09:00:00Z",
"updated_at": "2024-01-16T15:00:00Z",
"purchase_order_id": "po_987654321",
"purchase_order_number": "PO-2024-00124",
"supplier": {
"id": "sup_def456",
"name": "TechConnect Wholesale"
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center"
},
"shipment_date": "2024-01-16T08:00:00Z",
"expected_arrival_date": "2024-01-19T14:00:00Z",
"tracking_info": {
"carrier": "FedEx",
"tracking_number": "123456789012",
"current_status": "In Transit",
"last_update": "2024-01-16T15:00:00Z"
},
"item_summary": {
"total_items": 5,
"total_quantity": 2500,
"total_value": {
"amount": 1875000,
"currency": "USD"
}
}
}
],
"has_more": true,
"total_count": 15,
"next_cursor": "eyJpZCI6ImFzbl94eXo3ODlkZWY0NTYifQ=="
}
List ASNs
Retrieve a paginated list of ASNs with filtering options
GET
/
api
/
v1
/
asns
curl --location --request GET 'https://api.stateset.com/api/v1/asns?status=in_transit&warehouse_id=wh_001&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY'
query ListASNs(
$limit: Int
$offset: Int
$status: ASNStatus
$warehouse_id: String
$expected_arrival_after: DateTime
) {
asns(
limit: $limit
offset: $offset
status: $status
warehouse_id: $warehouse_id
expected_arrival_after: $expected_arrival_after
) {
data {
id
asn_number
status
supplier {
id
name
}
warehouse {
id
name
}
expected_arrival_date
tracking_info {
carrier
tracking_number
current_status
}
item_summary {
total_items
total_quantity
}
}
has_more
total_count
}
}
const asns = await stateset.asns.list({
status: 'in_transit',
warehouse_id: 'wh_001',
expected_arrival_after: '2024-01-15T00:00:00Z',
limit: 10,
sort_by: 'expected_arrival_date',
sort_order: 'asc'
});
// Iterate through all ASNs
for await (const asn of stateset.asns.list()) {
console.log(asn.asn_number, asn.status);
}
asns = stateset.asns.list(
status='in_transit',
warehouse_id='wh_001',
expected_arrival_after='2024-01-15T00:00:00Z',
limit=10,
sort_by='expected_arrival_date',
sort_order='asc'
)
# Iterate through all ASNs
for asn in stateset.asns.list():
print(asn.asn_number, asn.status)
{
"object": "list",
"data": [
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "in_transit",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-16T08:00:00Z",
"purchase_order_id": "po_123456789",
"purchase_order_number": "PO-2024-00123",
"supplier": {
"id": "sup_abc123",
"name": "AudioTech Suppliers Inc."
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center"
},
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"current_status": "In Transit",
"last_update": "2024-01-16T08:00:00Z"
},
"item_summary": {
"total_items": 2,
"total_quantity": 1500,
"total_value": {
"amount": 4200000,
"currency": "USD"
}
}
},
{
"id": "asn_xyz789def456",
"object": "asn",
"asn_number": "ASN-2024-00002",
"status": "in_transit",
"created_at": "2024-01-16T09:00:00Z",
"updated_at": "2024-01-16T15:00:00Z",
"purchase_order_id": "po_987654321",
"purchase_order_number": "PO-2024-00124",
"supplier": {
"id": "sup_def456",
"name": "TechConnect Wholesale"
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center"
},
"shipment_date": "2024-01-16T08:00:00Z",
"expected_arrival_date": "2024-01-19T14:00:00Z",
"tracking_info": {
"carrier": "FedEx",
"tracking_number": "123456789012",
"current_status": "In Transit",
"last_update": "2024-01-16T15:00:00Z"
},
"item_summary": {
"total_items": 5,
"total_quantity": 2500,
"total_value": {
"amount": 1875000,
"currency": "USD"
}
}
}
],
"has_more": true,
"total_count": 15,
"next_cursor": "eyJpZCI6ImFzbl94eXo3ODlkZWY0NTYifQ=="
}
Query Parameters
integer
Number of ASNs to return (default: 20, max: 100)
integer
Number of ASNs to skip (for pagination)
string
Cursor for pagination (alternative to offset)
string
Filter by status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
string
Filter by purchase order ID
string
Filter by supplier ID
string
Filter by destination warehouse ID
string
Filter by shipping carrier
string
Filter ASNs with expected arrival after this date (ISO 8601)
string
Filter ASNs with expected arrival before this date (ISO 8601)
string
Filter ASNs created after this date (ISO 8601)
string
Filter ASNs created before this date (ISO 8601)
boolean
Filter ASNs with receiving discrepancies
string
Search by ASN number, tracking number, or supplier name
string
Sort field: “created_at”, “expected_arrival_date”, “asn_number”, “status” (default: “created_at”)
string
Sort order: “asc” or “desc” (default: “desc”)
Response
string
Always “list”
array
Array of ASN objects
boolean
Whether there are more ASNs to retrieve
integer
Total number of ASNs matching the filters
string
Cursor for retrieving the next page
curl --location --request GET 'https://api.stateset.com/api/v1/asns?status=in_transit&warehouse_id=wh_001&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY'
query ListASNs(
$limit: Int
$offset: Int
$status: ASNStatus
$warehouse_id: String
$expected_arrival_after: DateTime
) {
asns(
limit: $limit
offset: $offset
status: $status
warehouse_id: $warehouse_id
expected_arrival_after: $expected_arrival_after
) {
data {
id
asn_number
status
supplier {
id
name
}
warehouse {
id
name
}
expected_arrival_date
tracking_info {
carrier
tracking_number
current_status
}
item_summary {
total_items
total_quantity
}
}
has_more
total_count
}
}
const asns = await stateset.asns.list({
status: 'in_transit',
warehouse_id: 'wh_001',
expected_arrival_after: '2024-01-15T00:00:00Z',
limit: 10,
sort_by: 'expected_arrival_date',
sort_order: 'asc'
});
// Iterate through all ASNs
for await (const asn of stateset.asns.list()) {
console.log(asn.asn_number, asn.status);
}
asns = stateset.asns.list(
status='in_transit',
warehouse_id='wh_001',
expected_arrival_after='2024-01-15T00:00:00Z',
limit=10,
sort_by='expected_arrival_date',
sort_order='asc'
)
# Iterate through all ASNs
for asn in stateset.asns.list():
print(asn.asn_number, asn.status)
{
"object": "list",
"data": [
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "in_transit",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-16T08:00:00Z",
"purchase_order_id": "po_123456789",
"purchase_order_number": "PO-2024-00123",
"supplier": {
"id": "sup_abc123",
"name": "AudioTech Suppliers Inc."
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center"
},
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"current_status": "In Transit",
"last_update": "2024-01-16T08:00:00Z"
},
"item_summary": {
"total_items": 2,
"total_quantity": 1500,
"total_value": {
"amount": 4200000,
"currency": "USD"
}
}
},
{
"id": "asn_xyz789def456",
"object": "asn",
"asn_number": "ASN-2024-00002",
"status": "in_transit",
"created_at": "2024-01-16T09:00:00Z",
"updated_at": "2024-01-16T15:00:00Z",
"purchase_order_id": "po_987654321",
"purchase_order_number": "PO-2024-00124",
"supplier": {
"id": "sup_def456",
"name": "TechConnect Wholesale"
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center"
},
"shipment_date": "2024-01-16T08:00:00Z",
"expected_arrival_date": "2024-01-19T14:00:00Z",
"tracking_info": {
"carrier": "FedEx",
"tracking_number": "123456789012",
"current_status": "In Transit",
"last_update": "2024-01-16T15:00:00Z"
},
"item_summary": {
"total_items": 5,
"total_quantity": 2500,
"total_value": {
"amount": 1875000,
"currency": "USD"
}
}
}
],
"has_more": true,
"total_count": 15,
"next_cursor": "eyJpZCI6ImFzbl94eXo3ODlkZWY0NTYifQ=="
}
⌘I