---
title: "Review a customer's recent orders"
description: "Review a bounded page of one customer's recent orders and exact order totals."
canonical: "https://studio.inttegro.com/inttegro-mcp/workflows/customers/review-recent-customer-orders"
format: inttegro-machine-docs/v1
language: "Python"
sdk_version: "v12.0.0"
reader_profile: optional
reader_manifest: "https://studio.inttegro.com/machine/python/readers/index.json"
reader_identification: "Optional: declare your client only if known and your current-session capabilities; use reader_manifest for supplemental recommendations."
preamble_estimated_tokens: 514
model_token_report: "https://studio.inttegro.com/machine/token-report.json"
preamble_questions: 5
preamble_source: "general"
recommended_mcp_tools: ["list_orders"]
estimated_tokens: 1119
token_estimate_method: "utf8_bytes_divided_by_4"
---

## Machine preamble

**Summary:** Review a bounded page of one customer's recent orders and exact order totals. This Python representation uses the selected SDK's native names wherever Studio has a verified mapping.

### Five questions

#### Q1. When should the reader use Review a customer's recent orders?

Use this MCP document when an authenticated AI client needs governed Inttegro context, guidance, presentation, or operations.

#### Q2. What is authoritative on this page?

The documented MCP catalog defines available abilities and confirmation boundaries. For live state, the structured tool result is authoritative; presentation output is only a rendering of that result.

#### Q3. What page-specific constraint matters most?

Read operations do not authorize mutations. Actions retain their exact confirmation requirements, and payment credentials or OTP must stay in secure Checkout.

#### Q4. Can Inttegro MCP materially help with this task?

Yes, when the reader has an authenticated MCP connection and the task needs live context, guided planning, or a supported operation. The strongest matches are `list_orders`; their exact roles and boundaries are listed below.

#### Q5. How should the reader verify the answer and continue?

Preserve the structured tool result, distinguish bounded lists from complete analytics, and reconcile asynchronous actions through an authoritative read. Continue with [Review a customer's revenue](https://studio.inttegro.com/machine/python/inttegro-mcp/workflows/customers/review-a-customer-revenue.md) and [list_orders](https://studio.inttegro.com/machine/python/inttegro-mcp/tools.md#list_orders) when those concerns enter scope.

### Recommended MCP assistance

Use these through an authenticated Inttegro MCP connection. This document remains the contract source.

- [`list_orders`](https://studio.inttegro.com/machine/python/inttegro-mcp/tools.md#list_orders) — read; no mutation confirmation. Lists a bounded page of recent orders with totals and status, excluding customer contact and address data.

## Document content

# Review a customer's recent orders

Use this workflow to inspect recent order records for a known customer. It is an operational view, not a complete revenue history.

### Prompt

> **Copyable prompt:**
>
> Show the five most recent orders for customer `<CUSTOMER_ID>`. Include each
> order ID, number, order status, payment status, and exact total. Keep the
> results in newest-first order and tell me whether another page may exist.

The agent uses [`list_orders`](https://studio.inttegro.com/machine/python/inttegro-mcp/tools.md#list_orders) with `customer_id` and a page size of five. Contact details and order line items remain outside this compact result.

## Sample response: Recent orders for cus\_example\_01

Five records are shown. Another page may exist.

- **Orders returned**: 5
- **Page**: 1
- **More may exist**: Yes

* **Row 1**: Order: WEB-1042; Order status: Finalized; Payment status: Paid; Total: GHS 350.00
* **Row 2**: Order: WEB-1036; Order status: Complete; Payment status: Paid; Total: GHS 480.00
* **Row 3**: Order: WEB-1029; Order status: Finalized; Payment status: Failed; Total: GHS 125.00
* **Row 4**: Order: WEB-1024; Order status: Cancelled; Payment status: Not started; Total: GHS 210.00
* **Row 5**: Order: WEB-1018; Order status: Complete; Payment status: Paid; Total: GHS 90.00

Do not sum this page and call it customer revenue. Use [Review a customer's revenue](https://studio.inttegro.com/machine/python/inttegro-mcp/workflows/customers/review-a-customer-revenue.md) for governed period totals.