# Fetch Order Items — Mews

> Retrieve order items using Mews Connector API. See the documentation

- Key: `mews-fetch-order-items`
- Type: Action (Read-only)
- Version: 0.1.0
- App: Mews (`mews`) — https://pipedream.com/apps/mews.md
- This page (HTML): https://pipedream.com/apps/mews/actions/fetch-order-items
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/mews/actions/fetch-order-items/fetch-order-items.mjs

## Description

Retrieve order items using Mews Connector API. [See the documentation](https://mews-systems.gitbook.io/connector-api/operations/orderitems#get-all-order-items)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `createdStartUtc` | `string` | No | Start of the interval in which Order item was created. ISO 8601 format. Eg. 2025-01-01T00:00:00Z |
| `createdEndUtc` | `string` | No | End of the interval in which Order item was created. ISO 8601 format. Max 3 months interval. Eg. 2025-01-01T00:00:00Z |
| `updatedStartUtc` | `string` | No | Start of the interval in which Order item was updated. ISO 8601 format. Eg. 2025-01-01T00:00:00Z |
| `updatedEndUtc` | `string` | No | End of the interval in which Order item was updated. ISO 8601 format. Max 3 months interval. Eg. 2025-01-01T00:00:00Z |
| `consumedStartUtc` | `string` | No | Start of the interval in which Order item was consumed. ISO 8601 format. Eg. 2025-01-01T00:00:00Z |
| `consumedEndUtc` | `string` | No | End of the interval in which Order item was consumed. ISO 8601 format. Max 3 months interval. Eg. 2025-01-01T00:00:00Z |
| `canceledStartUtc` | `string` | No | Start of the interval in which Order item was canceled. ISO 8601 format. Eg. 2025-01-01T00:00:00Z |
| `canceledEndUtc` | `string` | No | End of the interval in which Order item was canceled. ISO 8601 format. Max 3 months interval. Eg. 2025-01-01T00:00:00Z |
| `closedStartUtc` | `string` | No | Start of the interval in which Order item was closed. ISO 8601 format. Eg. 2025-01-01T00:00:00Z |
| `closedEndUtc` | `string` | No | End of the interval in which Order item was closed. ISO 8601 format. Max 3 months interval. Eg. 2025-01-01T00:00:00Z |
| `enterpriseIds` | `string[]` | No | Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token. Max 1000 items. Options are loaded from the connected account. |
| `orderItemIds` | `string[]` | No | Unique identifiers of the Order items. Required if no other filter is provided. Max 1000 items. Options are loaded from the connected account. |
| `accountType` | `string` | Yes | Type of account to be charged |
| `accountIds` | `string[]` | No | Unique identifiers of specific Accounts to which the order items belong to. Required if no other filter is provided. Max 100 items. Options are loaded from the connected account. |
| `serviceOrderIds` | `string[]` | No | Unique identifiers of the service orders (product service orders or reservations). Required if no other filter is provided. Max 1000 items. Options are loaded from the connected account. |
| `serviceIds` | `string[]` | No | Unique identifiers of the Services. Required if no other filter is provided. Max 1000 items. Options are loaded from the connected account. |
| `billIds` | `string[]` | No | Unique identifiers of the Bills to which order item is assigned. Required if no other filter is provided. Max 1000 items. Options are loaded from the connected account. |
| `currency` | `string` | No | ISO-4217 code of the Currency the item costs should be converted to. |
| `accountingStates` | `string[]` | No | Accounting state of the item. Max 1000 items. |
| `types` | `string[]` | No | Order item type, e.g. whether product order or space order. Max 1000 items. |
| `maxResults` | `integer` | No | Maximum number of records to return (min 1, max 99999). Leave blank to return every matching record. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "mews",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "mews-fetch-order-items",
  arguments: {
    createdStartUtc: "Created Start (UTC)",
    createdEndUtc: "Created End (UTC)",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mews-fetch-order-items",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mews: { authProvisionId: "apn_xxxxxxx" },
    createdStartUtc: "Created Start (UTC)",
    createdEndUtc: "Created End (UTC)",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "mews-fetch-order-items",
    "configured_props": {
      "mews": { "authProvisionId": "apn_xxxxxxx" },
      "createdStartUtc": "Created Start (UTC)",
      "createdEndUtc": "Created End (UTC)"
    }
  }'
```

---

- App: https://pipedream.com/apps/mews.md · All apps: https://pipedream.com/apps