curl --location --request GET 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'
query GetASN($id: ID!) {
asn(id: $id) {
id
asn_number
status
supplier {
id
name
}
warehouse {
id
name
}
shipment_date
expected_arrival_date
actual_arrival_date
tracking_info {
carrier
tracking_number
tracking_url
current_status
}
items {
id
sku
product_name
quantity_shipped
quantity_received
status
discrepancies {
type
expected
actual
notes
}
}
receiving_data {
received_date
received_by
total_items_received
discrepancy_count
}
}
}
const asn = await stateset.asns.retrieve(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
include_receiving_data: true,
include_tracking_history: true
}
);
asn = stateset.asns.retrieve(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
include_receiving_data=True,
include_tracking_history=True
)
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "delivered",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-18T11:15:00Z",
"purchase_order_id": "po_123456789",
"purchase_order_number": "PO-2024-00123",
"supplier": {
"id": "sup_abc123",
"name": "AudioTech Suppliers Inc.",
"contact_email": "shipping@audiotech.com"
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center",
"address": {
"line1": "123 Warehouse Way",
"city": "Los Angeles",
"state": "CA",
"postal_code": "90001",
"country": "US"
}
},
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"service_type": "Ground",
"tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
"current_status": "Delivered",
"last_update": "2024-01-18T09:30:00Z",
"tracking_history": [
{
"timestamp": "2024-01-15T14:15:00Z",
"status": "Picked up",
"location": "San Francisco, CA"
},
{
"timestamp": "2024-01-16T22:00:00Z",
"status": "In transit",
"location": "Fresno, CA"
},
{
"timestamp": "2024-01-18T06:00:00Z",
"status": "Out for delivery",
"location": "Los Angeles, CA"
},
{
"timestamp": "2024-01-18T09:30:00Z",
"status": "Delivered",
"location": "Los Angeles, CA"
}
]
},
"items": [
{
"id": "asn_item_123",
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_shipped": 500,
"quantity_ordered": 500,
"quantity_received": 0,
"unit_cost": {
"amount": 7500,
"currency": "USD"
},
"lot_number": "LOT-2024-001",
"status": "pending_receipt"
},
{
"id": "asn_item_124",
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_shipped": 1000,
"quantity_ordered": 1000,
"quantity_received": 0,
"unit_cost": {
"amount": 450,
"currency": "USD"
},
"lot_number": "LOT-2024-002",
"status": "pending_receipt"
}
],
"packaging_details": {
"total_packages": 10,
"total_pallets": 2,
"total_weight": {
"value": 250,
"unit": "lb"
},
"packages": [
{
"package_id": "PKG001",
"type": "pallet",
"tracking_number": "1Z999AA10123456784"
}
]
},
"shipping_documents": [
{
"type": "packing_list",
"document_number": "PL-2024-00001",
"url": "https://documents.stateset.com/packing-lists/PL-2024-00001.pdf"
}
],
"receiving_data": null,
"notes": "Please schedule receiving appointment. Fragile electronics.",
"metadata": {}
}
Get ASN
Retrieve a single ASN by ID with full shipment details
GET
/
v1
/
asns
/
:id
curl --location --request GET 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'
query GetASN($id: ID!) {
asn(id: $id) {
id
asn_number
status
supplier {
id
name
}
warehouse {
id
name
}
shipment_date
expected_arrival_date
actual_arrival_date
tracking_info {
carrier
tracking_number
tracking_url
current_status
}
items {
id
sku
product_name
quantity_shipped
quantity_received
status
discrepancies {
type
expected
actual
notes
}
}
receiving_data {
received_date
received_by
total_items_received
discrepancy_count
}
}
}
const asn = await stateset.asns.retrieve(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
include_receiving_data: true,
include_tracking_history: true
}
);
asn = stateset.asns.retrieve(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
include_receiving_data=True,
include_tracking_history=True
)
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "delivered",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-18T11:15:00Z",
"purchase_order_id": "po_123456789",
"purchase_order_number": "PO-2024-00123",
"supplier": {
"id": "sup_abc123",
"name": "AudioTech Suppliers Inc.",
"contact_email": "shipping@audiotech.com"
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center",
"address": {
"line1": "123 Warehouse Way",
"city": "Los Angeles",
"state": "CA",
"postal_code": "90001",
"country": "US"
}
},
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"service_type": "Ground",
"tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
"current_status": "Delivered",
"last_update": "2024-01-18T09:30:00Z",
"tracking_history": [
{
"timestamp": "2024-01-15T14:15:00Z",
"status": "Picked up",
"location": "San Francisco, CA"
},
{
"timestamp": "2024-01-16T22:00:00Z",
"status": "In transit",
"location": "Fresno, CA"
},
{
"timestamp": "2024-01-18T06:00:00Z",
"status": "Out for delivery",
"location": "Los Angeles, CA"
},
{
"timestamp": "2024-01-18T09:30:00Z",
"status": "Delivered",
"location": "Los Angeles, CA"
}
]
},
"items": [
{
"id": "asn_item_123",
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_shipped": 500,
"quantity_ordered": 500,
"quantity_received": 0,
"unit_cost": {
"amount": 7500,
"currency": "USD"
},
"lot_number": "LOT-2024-001",
"status": "pending_receipt"
},
{
"id": "asn_item_124",
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_shipped": 1000,
"quantity_ordered": 1000,
"quantity_received": 0,
"unit_cost": {
"amount": 450,
"currency": "USD"
},
"lot_number": "LOT-2024-002",
"status": "pending_receipt"
}
],
"packaging_details": {
"total_packages": 10,
"total_pallets": 2,
"total_weight": {
"value": 250,
"unit": "lb"
},
"packages": [
{
"package_id": "PKG001",
"type": "pallet",
"tracking_number": "1Z999AA10123456784"
}
]
},
"shipping_documents": [
{
"type": "packing_list",
"document_number": "PL-2024-00001",
"url": "https://documents.stateset.com/packing-lists/PL-2024-00001.pdf"
}
],
"receiving_data": null,
"notes": "Please schedule receiving appointment. Fragile electronics.",
"metadata": {}
}
Path Parameters
string
required
The unique identifier of the ASN to retrieve
Query Parameters
boolean
Include detailed receiving data if available (default: true)
boolean
Include tracking status history (default: false)
Response
string
Unique ASN identifier
string
Always “asn”
string
System-generated ASN number
string
Current status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
string
ISO 8601 timestamp of creation
string
ISO 8601 timestamp of last update
string
Associated purchase order ID
object
Supplier information
object
Destination warehouse details
string
Date when shipment was sent
string
Expected delivery date
string
Actual delivery date (when delivered)
object
Shipping and tracking details
array
Array of items with shipping and receiving details
object
Packaging and palletization information
object
array
Related shipping documents
string
Additional notes or instructions
object
Custom metadata fields
curl --location --request GET 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'
query GetASN($id: ID!) {
asn(id: $id) {
id
asn_number
status
supplier {
id
name
}
warehouse {
id
name
}
shipment_date
expected_arrival_date
actual_arrival_date
tracking_info {
carrier
tracking_number
tracking_url
current_status
}
items {
id
sku
product_name
quantity_shipped
quantity_received
status
discrepancies {
type
expected
actual
notes
}
}
receiving_data {
received_date
received_by
total_items_received
discrepancy_count
}
}
}
const asn = await stateset.asns.retrieve(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
include_receiving_data: true,
include_tracking_history: true
}
);
asn = stateset.asns.retrieve(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
include_receiving_data=True,
include_tracking_history=True
)
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "delivered",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-18T11:15:00Z",
"purchase_order_id": "po_123456789",
"purchase_order_number": "PO-2024-00123",
"supplier": {
"id": "sup_abc123",
"name": "AudioTech Suppliers Inc.",
"contact_email": "shipping@audiotech.com"
},
"warehouse": {
"id": "wh_001",
"name": "Main Distribution Center",
"address": {
"line1": "123 Warehouse Way",
"city": "Los Angeles",
"state": "CA",
"postal_code": "90001",
"country": "US"
}
},
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"service_type": "Ground",
"tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
"current_status": "Delivered",
"last_update": "2024-01-18T09:30:00Z",
"tracking_history": [
{
"timestamp": "2024-01-15T14:15:00Z",
"status": "Picked up",
"location": "San Francisco, CA"
},
{
"timestamp": "2024-01-16T22:00:00Z",
"status": "In transit",
"location": "Fresno, CA"
},
{
"timestamp": "2024-01-18T06:00:00Z",
"status": "Out for delivery",
"location": "Los Angeles, CA"
},
{
"timestamp": "2024-01-18T09:30:00Z",
"status": "Delivered",
"location": "Los Angeles, CA"
}
]
},
"items": [
{
"id": "asn_item_123",
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_shipped": 500,
"quantity_ordered": 500,
"quantity_received": 0,
"unit_cost": {
"amount": 7500,
"currency": "USD"
},
"lot_number": "LOT-2024-001",
"status": "pending_receipt"
},
{
"id": "asn_item_124",
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_shipped": 1000,
"quantity_ordered": 1000,
"quantity_received": 0,
"unit_cost": {
"amount": 450,
"currency": "USD"
},
"lot_number": "LOT-2024-002",
"status": "pending_receipt"
}
],
"packaging_details": {
"total_packages": 10,
"total_pallets": 2,
"total_weight": {
"value": 250,
"unit": "lb"
},
"packages": [
{
"package_id": "PKG001",
"type": "pallet",
"tracking_number": "1Z999AA10123456784"
}
]
},
"shipping_documents": [
{
"type": "packing_list",
"document_number": "PL-2024-00001",
"url": "https://documents.stateset.com/packing-lists/PL-2024-00001.pdf"
}
],
"receiving_data": null,
"notes": "Please schedule receiving appointment. Fragile electronics.",
"metadata": {}
}
⌘I