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": {}
}

Path Parameters

id
string
required
The unique identifier of the ASN to retrieve

Query Parameters

include_receiving_data
boolean
Include detailed receiving data if available (default: true)
include_tracking_history
boolean
Include tracking status history (default: false)

Response

id
string
Unique ASN identifier
object
string
Always “asn”
asn_number
string
System-generated ASN number
status
string
Current status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
created_at
string
ISO 8601 timestamp of creation
updated_at
string
ISO 8601 timestamp of last update
purchase_order_id
string
Associated purchase order ID
supplier
object
Supplier information
warehouse
object
Destination warehouse details
shipment_date
string
Date when shipment was sent
expected_arrival_date
string
Expected delivery date
actual_arrival_date
string
Actual delivery date (when delivered)
tracking_info
object
Shipping and tracking details
items
array
Array of items with shipping and receiving details
packaging_details
object
Packaging and palletization information
receiving_data
object
Receiving information if ASN has been processed
shipping_documents
array
Related shipping documents
notes
string
Additional notes or instructions
metadata
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'
{
  "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": {}
}