Get ASN

Retrieve a single ASN by ID with full shipment details

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

Show Receiving data properties

received_date · string

Date when items were received

received_by · string

User who processed the receiving

discrepancies · array

Any discrepancies found during receiving

notes · string

Receiving notes

shipping_documents · array

Related shipping documents

notes · string

Additional notes or instructions

metadata · object

Custom metadata fields

cURL

curl --location --request GET 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "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": "[e-mail]"
  },
  "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": {}
}