---
title: "Generate sales by customer · Reports · COUNT Partner API"
description: "Summarizes invoice line revenue and quantity by customer. POST /partners/reports/sales-by-customer"
canonical: "https://developers.getcount.com/reference/reports/generate-sales-by-customer"
source: "https://developers.getcount.com/reference/reports/generate-sales-by-customer"
---
[Reports](https://developers.getcount.com/reference/reports) / Generate sales by customer

# Generate sales by customer

POST `/partners/reports/sales-by-customer`

Summarizes invoice line revenue and quantity by customer.

Sales-only aggregation of invoice line items over a date range. Distinct from customer activity, which nets all journal entries per customer.

HMAC signature + Bearer access token

[Try this request](https://developers.getcount.com/tools/try-it?method=POST&path=%2Fpartners%2Freports%2Fsales-by-customer)

[Chart of Accounts API](https://developers.getcount.com/reference/chart-of-accounts) [Tags API](https://developers.getcount.com/reference/tags) [Workspace Stats API](https://developers.getcount.com/reference/workspace-stats)

#### Query parameters

`startDate` date optional

Report period start.

`endDate` date optional

Report period end.

`currency` string optional

Report currency. Defaults to workspace currency.

`transactionStatus` enum optional

Filter transactions by review/reconciliation state.

One of: `all`, `reviewed`, `unreviewed`, `reconciled`, `unreconciled`

`customerUuids` string optional

Comma-separated customer UUIDs.

`reportType` enum optional

Accounting basis for the report.

One of: `accrual`, `cash`

#### Responses

`200` Sales by customer report generated.

`400` Invalid filters.

`401` Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

`403` The credential does not have access to this workspace or resource. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-403)

`429` Rate limit exceeded (100 requests per minute per clientId). Retry after the Retry-After header. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-429)

[Previous POST Generate sales by product/service](https://developers.getcount.com/reference/reports/generate-sales-by-product-service) [Next POST Generate customer activity report](https://developers.getcount.com/reference/reports/generate-customer-report)

POST `https://api.getcount.com/partners/reports/sales-by-customer`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'POST';
const signingPath = '/reports/sales-by-customer';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';

const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/reports/sales-by-customer`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
});

console.log(await response.json());
```

Response · 200

```json
{
  "status": "success",
  "message": "Success on generating sales by customer report",
  "data": {
    "customersSales": [
      {
        "uuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
        "name": "Acme Corporation",
        "totalSales": 45000,
        "totalQuantity": 120
      }
    ],
    "totals": {
      "totalSales": 45000,
      "totalQuantity": 120
    }
  }
}
```