# Summarize unified revenue records

`GET https://api.suger.cloud/org/{orgId}/revenue/records/summary`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `search` | query | string | no | Case-insensitive search over buyer name, invoice ID, buyer ID, entitlement ID, disbursement reference number, and offer external ID |
| `partner` | query | string | no | Partner filter (AWS, AZURE, GCP, STRIPE, CRM_*) |
| `lifecycleStage` | query | string | no | Lifecycle stage filter (BILLING, CASH_COLLECTED, DISBURSED) |
| `buyerId` | query | string | no | Buyer ID filter |
| `productId` | query | string | no | Product ID filter |
| `startDate` | query | string | no | Earliest invoice_date (RFC3339 or YYYY-MM-DD) |
| `endDate` | query | string | no | Latest invoice_date (RFC3339 or YYYY-MM-DD) |
| `currency` | query | string | no | ISO 4217 currency code |
| `recognitionStatus` | query | string | no | Recognition status filter |

## Responses

### 200 — OK

Content-Type: `application/json` · Schema: `RevenueRecordSummaryResponse`

### 400 — Invalid filter value

Content-Type: `application/json`

---

Interactive API reference: https://doc.suger.io/api/