Sales orders

Get an order

Requires orders:read. Read an API-created order in the token's store by its ord_… ID.

get/api/external/v1/orders/{order_id}

Request

  • Base URL: http://localhost
  • URL: http://localhost/api/external/v1/orders/{order_id}
  • Auth: HTTP bearer

Response

Example response

{
  "data": {
    "id": "ord_x7Kq9",
    "vendor_identifier": "external-api:1:order:example",
    "external_reference": "ERP-1001",
    "name": "#1001",
    "currency": "USD",
    "total_price": "249.00",
    "total_taxes": "49.80",
    "shipping_price": "49.00",
    "weight_grams": null,
    "financial_status": "AUTHORIZED",
    "fulfillment_status": "UNFULFILLED",
    "placed_at": "2026-09-07T10:00:00+00:00",
    "merchant_reference1": "#1001",
    "merchant_reference2": null,
    "customer": {
      "first_name": "Anna",
      "last_name": "Andersson",
      "company": null,
      "address1": "Drottninggatan 1",
      "address2": null,
      "postal_code": "11151",
      "city": "Stockholm",
      "state": null,
      "country": "SE",
      "phone": "+46701234567",
      "email": "anna@example.com",
      "customer_type": null
    },
    "line_items": [
      {
        "external_reference": "LINE-1",
        "name": "Blue shirt",
        "sku": "SHIRT-BLUE-M",
        "quantity": 2,
        "unit_price": "100.00",
        "type": "physical",
        "tax_rate_basis_points": 2500,
        "total_tax_amount": "40.00",
        "attributes": {}
      }
    ],
    "metadata": {},
    "created_at": "2026-09-07T10:00:00+00:00",
    "updated_at": "2026-09-07T10:00:00+00:00",
    "fulfillment_orders": [
      {
        "external_reference": "WAREHOUSE-A",
        "shipping_method_id": null,
        "service_point_id": null,
        "location_id": "loc_x7Kq9",
        "shipping": {
          "name": null,
          "type": null,
          "class": null,
          "carrier": null,
          "tax_rate_basis_points": null,
          "location": null
        },
        "status": "OPEN",
        "request_status": "UNSUBMITTED",
        "line_items": [
          {
            "order_line_reference": "LINE-1",
            "quantity": 1,
            "quantity_remaining": 1,
            "weight_grams": 250
          }
        ]
      },
      {
        "external_reference": "WAREHOUSE-B",
        "shipping_method_id": null,
        "service_point_id": null,
        "location_id": "loc_x7Kq9",
        "shipping": {
          "name": null,
          "type": null,
          "class": null,
          "carrier": null,
          "tax_rate_basis_points": null,
          "location": null
        },
        "status": "OPEN",
        "request_status": "UNSUBMITTED",
        "line_items": [
          {
            "order_line_reference": "LINE-1",
            "quantity": 1,
            "quantity_remaining": 1,
            "weight_grams": 250
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.