> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify: List Orders

List recent orders from your Shopify store. Filter by financial status, fulfillment status, or date range. Returns order details including line items and customer info. Ideal for: order monitoring, fulfillment tracking, sales analysis. Required scope: read_orders.

![Shopify: List Orders logo](https://ai-icon.b3.fun/logo/shopify)
Catalog action Integrations shopify

List recent orders from your Shopify store. Filter by financial status, fulfillment status, or date range. Returns order details including line items and customer info. Ideal for: order monitoring, fulfillment tracking, sales analysis. Required scope: read_orders.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `shopify-list-orders` |
| Category | Integrations |
| Connector | `shopify` |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `shopify`, `ecommerce`, `orders`, `list`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `financialStatus` | `string` | No | Filter orders by financial status \(default: all statuses\) |
| `fulfillmentStatus` | `string` | No | Filter orders by fulfillment status \(default: all statuses\) |
| `limit` | `number` | No | Maximum number of orders to return \(default: 10, max: 250\) |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | `boolean` | Yes | Whether the query was successful |
| `data` | `object` | No | Shopify API response data |
| `exports` | `object` | No | Exported values from the action |

## Examples

**Workflow node**

```json
{
  "type": "shopify-list-orders",
  "payload": {
    "financialStatus": "AUTHORIZED",
    "fulfillmentStatus": "FULFILLED",
    "limit": 10
  },
  "children": [],
  "connector": {
    "type": "shopify",
    "id": "conn_shopify"
  }
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/shopify-list-orders/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "financialStatus": "AUTHORIZED",
    "fulfillmentStatus": "FULFILLED",
    "limit": 10
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.