Orders API

The Orders API provides endpoints for retrieving and managing Shopify orders.

Poll Recent Orders

Retrieves the most recent orders from Shopify with detailed information including line items, customer data, and shipping addresses.

GET /api/orders/poll

Both GET and POST methods are supported for this endpoint.

Response

success

boolean

Whether the request was successful

orders

array

Array of recent orders (up to 10)

Show Order Object

string

Shopify order ID (GraphQL format)

name

string

Order name (e.g., “#1001”)

createdAt

string

Order creation timestamp (ISO 8601)

financialStatus

string

Financial status (PENDING, AUTHORIZED, PAID, etc.)

fulfillmentStatus

string

Fulfillment status (UNFULFILLED, PARTIAL, FULFILLED, etc.)

totalPrice

string

Total order amount

currency

string

Currency code (e.g., “USD”, “EUR”)

lineItems

array

Order line items

Show Line Item

string

Line item ID

name

string

Product name

quantity

integer

Quantity ordered

variant

string

Variant title

sku

string

SKU code

productId

string

Product ID

shippingAddress

object

Shipping address details

Show Address Fields

firstName

string

First name

lastName

string

Last name

address1

string

Address line 1

city

string

City

province

string

State/Province

country

string

Country

zip

string

Postal code

phone

string

Phone number

customer

object

Customer information

Show Customer Fields

string

Customer ID

string

Email address

firstName

string

First name

lastName

string

Last name

phone

string

Phone number

Example Response

{
  "success": true,
  "orders": [
    {
      "id": "gid://shopify/Order/5678901234567890",
      "name": "#1001",
      "createdAt": "2026-03-04T10:30:00Z",
      "financialStatus": "PAID",
      "fulfillmentStatus": "UNFULFILLED",
      "totalPrice": "149.99",
      "currency": "USD",
      "lineItems": [
        {
          "id": "gid://shopify/LineItem/123",
          "name": "Premium Product",
          "quantity": 2,
          "variant": "Small / Red",
          "sku": "PROD-SM-RED",
          "productId": "gid://shopify/Product/7891234567890"
        }
      ],
      "shippingAddress": {
        "firstName": "John",
        "lastName": "Doe",
        "address1": "123 Main St",
        "city": "New York",
        "province": "NY",
        "country": "United States",
        "zip": "10001",
        "phone": "+1234567890"
      },
      "customer": {
        "id": "gid://shopify/Customer/987654321",
        "email": "john.doe@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "phone": "+1234567890"
      },
      "tags": ["ecomdrop-pending"],
      "note": "Please ship ASAP"
    }
  ],
  "count": 1
}

This endpoint returns the 10 most recent orders sorted by creation date (newest first).

Requires appropriate Shopify API permissions to access order data.

API Overview

Endpoints

Database

Poll Recent Orders

Response

Example Response

Build docs developers (and LLMs) love

API Overview

Endpoints

Database

Documentation Index

​Poll Recent Orders

​Response

​Example Response

Build docs developers (and LLMs) love

Poll Recent Orders

Response

Example Response