View as Markdown
Mews icon

Mews ACTION

Fetch Bills

Retrieve bills using Mews Connector API. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mews account once, then configure and run Fetch Bills from your backend or agent.

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-bills",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mews: { authProvisionId: "apn_xxxxxxx" },
    enterpriseIds: ["Enterprise IDs"],
    billIds: ["Bill IDs"],
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Fetch Bills inputs
Property Type Description
enterpriseIds Enterprise IDs string[]
Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token. Max 1000 items.
Optional Dynamic
billIds Bill IDs string[]
Unique identifiers (GUIDs) of the Bills. Required if no other filter is provided (max 1000 items).
Optional Dynamic
customerIds Customer IDs string[]
Unique identifiers (GUIDs) of the Customers the bills are issued to, as returned by Fetch Customers (max 1000 items).
Optional Dynamic
issuedStartUtc Issued Start (UTC) string
Start of the interval in which the Bill was issued. ISO 8601 format. Eg. 2025-01-01T00:00:00Z
Optional
issuedEndUtc Issued End (UTC) string
End of the interval in which the Bill was issued. ISO 8601 format (max 3 months interval). Eg. 2025-01-01T00:00:00Z
Optional
paidStartUtc Paid Start (UTC) string
Start of the interval in which the Bill was paid. ISO 8601 format. Eg. 2025-01-01T00:00:00Z
Optional
paidEndUtc Paid End (UTC) string
End of the interval in which the Bill was paid. ISO 8601 format (max 3 months interval). Eg. 2025-01-01T00:00:00Z
Optional
dueStartUtc Due Start (UTC) string
Start of the interval in which the Bill is due to be paid. ISO 8601 format. Eg. 2025-01-01T00:00:00Z
Optional
dueEndUtc Due End (UTC) string
End of the interval in which the Bill is due to be paid. ISO 8601 format (max 3 months interval). Eg. 2025-01-01T00:00:00Z
Optional
createdStartUtc Created Start (UTC) string
Start of the interval in which the Bill was created. ISO 8601 format. Eg. 2025-01-01T00:00:00Z
Optional
createdEndUtc Created End (UTC) string
End of the interval in which the Bill was created. ISO 8601 format (max 3 months interval). Eg. 2025-01-01T00:00:00Z
Optional
updatedStartUtc Updated Start (UTC) string
Start of the interval in which the Bill was updated. ISO 8601 format. Eg. 2025-01-01T00:00:00Z
Optional
updatedEndUtc Updated End (UTC) string
End of the interval in which the Bill was updated. ISO 8601 format (max 3 months interval). Eg. 2025-01-01T00:00:00Z
Optional
state State string
State the bills should be in. If not specified, both Open and Closed bills are returned.
Optional
billType Type string
Type of the bills. If not specified, all types are returned. Receipt is a bill paid in full, Invoice is a bill issued to request payment.
Optional
correctionStates Correction States string[]
Whether to return regular bills, corrective bills, or both. If Bill IDs are specified, defaults to both, otherwise defaults to Bill.
Optional
maxResults Max Results integer
Maximum number of records to return (min 1, max 99999). Leave blank to return every matching record.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
mews-fetch-bills
Version
0.0.1
App
Mews
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes