---
api: 'Open Banking API'
---

# List draft payments

Get draft payments list sorted by creation time in descending order.

See also [Tutorials: Work with draft payments](/docs/guides/build-banking-apps/tutorials/work-with-draft-payments) and [Tutorials: Create your first draft payment](/docs/guides/build-banking-apps/tutorials/create-your-first-draft-payment#6-get-list-of-draft-payments).

## Endpoint

GET `/draft-payments`

## Parameters

### query parameters

- `from` (string, optional)
  Creation time inclusive lower bound in UTC [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) Date Time format YYYY-MM-DDThh:mm:ssZ

- `to` (string, optional)
  Creation time exclusive upper bound in UTC [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) Date Time format YYYY-MM-DDThh:mm:ssZ

- `limit` (integer, optional)
  Maximum number of items

## Returns

### 200

Draft Payment List

#### Response attributes

- `Items` (array of object)
  - `Items[].Id` (string)
      The ID of the draft payment.
  - `Items[].CreatedAt` (string)
      Date time when the draft payment was created.
  - `Items[].Status` (enum)
      The status of the draft payment.
      Possible enum values:

      - `Awaiting`
      - `Processed`
      - `Approved`
      - `Deleted`
  - `Items[].RequestedExecutionDate` (string, optional)
      The execution date the draft payment is requested.
  - `Items[].Title` (string, optional)
      Title of the draft payment.
- `Links` (object)
    Links relevant to the payload.
  - `Links.Next` (string, optional)
      Relative URI to the next page.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request |
| 403 | Forbidden |