---
title: "Aggregate count + time-series of the buyer’s payment requests"
method: GET
path: "/router/payments/summary"
tags: ["Router"]
---

# Aggregate count + time-series of the buyer’s payment requests

`GET /router/payments/summary`

## Request

- Base URL: `https://api.sandbox.nevermined.app/api/v1`
- URL: `https://api.sandbox.nevermined.app/api/v1/router/payments/summary`
- Auth: HTTP bearer

Returns the buyer’s total number of Router payment requests (uncapped — unlike the 1000-row
list endpoint) plus a per-bucket time-series for a dashboard chart. Filter by `from`/`to`
(ISO-8601, inclusive on `createdAt`); choose the bucket size with `granularity` (day/week/month).

## Query parameters

- `from` string
- `to` string
- `granularity` 'day' | 'week' | 'month'

## Response `200`

Total + time-series.

- PaymentsSummaryDto
  - `total` number, required: Total payment requests in the period. Uncapped, unlike the (1000-row-capped) list endpoint.
  - `series` PaymentsSummaryPointDto[], required: Per-bucket counts, oldest first.
    - `date` string, required: Start of the time bucket (ISO-8601, UTC), truncated to the requested granularity.
    - `value` number, required: Number of payment requests issued in the bucket.

## Other responses

- `400`: `from`/`to` are not valid ISO-8601 timestamps (BCK.ROUTER.0001).
- `401`: Missing/invalid Nevermined API key.

---

[API](https://skmtc.dev/nevermined/apis/nevermined-api.md) · [All operations](https://skmtc.dev/nevermined/apis/nevermined-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nevermined/apis/nevermined-api/revisions/cabbe618c80b?raw)