# /fulfillment-orders/:id(uuid)

#### `GET /fulfillment-orders/:id(uuid)`

#### Fetch a specific fulfillment order.

Body:

* `id` - The Purple Dot ID of the fulfillment order
* `status` -  The current status of the fulfillment order, which can be one of:
  * `UNFULFILLED` - the order has been placed and is waiting to be fulfilled
  * `FULFILLED` - all items have been fulfilled
  * `VOIDED` - the order was canceled
* `created_at` (ISO8610 timestamp) - When this fulfillment order was created (effectively, when Purple Dot was told the related line items are ready to be fulfilled)
* `purchased_at` (ISO8610 timestamp) - the `created_at` of the pre-order this fulfillment order originates from
* `reference` - The Purple Dot fulfillment order reference, defined as `concat(Purple Dot pre-order reference, fulfillment order index)`
* `currency` - The presentment currency of the order
* `customer` - The customer placing the order
  * `email` - The customer's email address
  * `external_id` - The Shopify ID of this customer, if we know it
  * `first_name`
  * `last_name`
  * `tags` - Shopify tags for the customer
  * `default_address`
    * `first_name`
    * `last_name`
    * `address1`
    * `address2`
    * `city`
    * `postal_code`
    * `province_code` - The ISO3166 code of the second level administrative subdivision
    * `country` - The English name of the country
    * `country_code` - The ISO3166 code of the country
    * `phone`
* `tax_included` - Whether the tax is included in listed prices or not
* `total_tax` - The total tax on the pre-order
* `total_discounts` - The total discounts applied to the fulfillment order
* `subtotal_price` - The total of the line items before taxes and shipping
* `total_price` - The fulfillment order total
* `line_items` - Array of line items in this fulfillment order
  * `id` - The Purple Dot ID of the line item
  * `price` - The unit cost of the product variant in this line item, before taxes/discounts etc
  * `total` - The total cost of this line item, after tax/discounts etc are considered
  * `taxable` - Whether the product variant in this line item is taxable
  * `tax_lines` - The taxes applied to the line item
    * `price`  - The total amount of tax for the line item
    * `rate`  - The tax rate as a decimal
    * `title`  - The name of the tax
    * `inclusive`  - Whether this tax is already included in the line item price
  * `total_discount` - The total amount of discounts applied to the line item
  * `quantity` - The quantity of the line item
  * `product_id` - The Shopify ID of the line item's product
  * `variant_id` - The Shopify ID of the line item's product variant
  * `sku` - The SKU code of the product variant in this line item
  * `name` - The name of the product variant in this line item
* `shipping_address`
  * `first_name`
  * `last_name`
  * `address1`
  * `address2`
  * `city`
  * `postal_code`
  * `province_code` - The ISO3166 code of the second level administrative subdivision
  * `country` - The English name of the country
  * `country_code` - The ISO3166 code of the country
  * `phone`
* `shipping_lines` - An array of shipping rates
  * `id` - The Purple Dot ID of the shipping line
  * `price` - The unit cost of this shipping line, before taxes/discounts etc
  * `total`- The total cost of this shipping line, after tax/discounts etc are considered
  * `title` - The user-facing name of the shipping rate
  * `code` - The shipping rate carrier code
  * `tax_lines` - The taxes applied to the shipping rate
    * `price`  - The total amount of tax for the shipping line
    * `rate`  - The tax rate as a decimal
    * `title`  - The name of the tax
    * `inclusive`  - Whether this tax is already included in the shipping line price
* `note` - optional notes from the Shopify order

Examples:

{% code overflow="wrap" %}

```
curl --request GET \
     --url 'https://www.purpledotprice.com/admin/api/v1/fulfillment_order/a1b2c3d4-e5f6-7890-1234-567890abcdef' \
     --header 'X-Purple-Dot-Access-Token: <access_token>'
```

{% endcode %}
