# The instalments still to come

The instalments still scheduled from today onwards, soonest first — what is due to be collected and when. `?through=` is an RFC3339 end of the window, `?limit=` caps the page (100 by default, 500 max). Reach for it to answer what is coming in this week or this month; `get_payments_overdue` has what is already late, and `get_portfolio_projection` answers the same question as weekly totals for the next quarter rather than row by row.

Access class: `workspace`.

## Endpoint

`GET /v1/payments/upcoming`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": [
    "string"
  ]
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```