curl --location --request GET 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"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'
{
"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": {}
}
Documentation Index
Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
Use this file to discover all available pages before exploring further.
Path Parameters
The unique identifier of the ASN to retrieve
Query Parameters
Include detailed receiving data if available (default: true)
Include tracking status history (default: false)
Response
Unique ASN identifier
Always “asn”
System-generated ASN number
Current status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
ISO 8601 timestamp of creation
ISO 8601 timestamp of last update
Associated purchase order ID
Supplier information
Destination warehouse details
Date when shipment was sent
Expected delivery date
Actual delivery date (when delivered)
Shipping and tracking details
Array of items with shipping and receiving details
Packaging and palletization information
Related shipping documents
Additional notes or instructions
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'
{
"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