Rentman icon

Rentman

Interact with the Rentman rental management API

Actions206

Purchase Order → Get Files

AI-generated

Summary

Retrieves the files attached to a Rentman purchase order via GET /purchaseorders/{id}/files, with optional pagination, filtering, sorting and field selection.

Inputs

  • Purchase Order ID (required) — ID of the purchase order whose files are listed; inserted into the request URL.
  • Return All — If true, follows next_page_url to fetch all pages; otherwise a single page is returned.
  • Limit — Maximum number of results (default 50, min 1). Shown only when Return All is off.
  • Offset — Number of results to skip (default 0). Shown only when Return All is off.
  • Expand — Comma-separated linkable fields to inline instead of returning paths; supports dot notation up to 3 levels.
  • Filters — Optional collection: created after, modified after/before, ID greater than, fields to return, sort (default +id), approval status, and supplier path. Approval status and supplier are purchase-order attributes and may not apply to file records.
  • Request Options — Node settings for batching, ignoring SSL issues, proxy and timeout (default 10000 ms).

Output shape

A list of file records attached to the specified purchase order, as returned by the Rentman API.

Without Return All, only one page up to the Limit is returned. Linked fields appear as paths unless expanded. The Fields filter restricts the returned properties.

Examples

Example 1: Download-ready list of all files on a purchase order

Purchase Order ID = 123, Return All = true

Example 2: Fetch the 10 most recently modified files

Purchase Order ID = 123, Limit = 10, Filters: Sort = -modified

Example 3: Incremental sync of new files

Purchase Order ID = 123, Return All = true, Filters: Modified After = last run time

Links

Discussion