---
title: "The latest payments, newest first"
method: GET
path: "/api/v1/payments/recent"
tags: ["Payments"]
---

# The latest payments, newest first

`GET /api/v1/payments/recent`

## Request

- Base URL: `http://localhost:5180`
- URL: `http://localhost:5180/api/v1/payments/recent`
- Auth: API key in cookie `better-auth.session_token`

The most recent payments by the day they were received, each with who paid and the reference the bank carried. This is the read for a tool that polls for new payments: the list at `/payments` pages in id order, where a new payment can sort anywhere.

## Query parameters

- `limit` integer

## Response `200`

The latest payments, newest first.

- object
  - `ok` unknown, required
  - `data` object, required
    - `payments` object[], required
      - `id` string, required: Stable record id, e.g. `lse_012`.
      - `teamId` string, required: Stable record id, e.g. `lse_012`.
      - `method` string, required
      - `amount` integer, required: Money, always in integer cents. €1,250.00 is 125000.
      - `currency` string, required
      - `receivedOn` string, required: A calendar date, `YYYY-MM-DD`.
      - `allocations` object[], required
        - `invoiceId` string, required: Stable record id, e.g. `lse_012`.
        - `amount` integer, required: Money, always in integer cents. €1,250.00 is 125000.
      - `unallocated` integer, required: Money received but not yet matched against an invoice.
      - `bankTransactionId` string: The bank movement this payment came off. Absent for one recorded by hand, which is why `collection.allInBank` can be false.
      - `payerName` string, nullable, required: Who paid: the contact the payment is recorded against, or else the name on the bank movement it came off.
      - `bankReference` string, nullable, required: What the bank movement carried: its structured reference, the bank’s own reference, or its free text.
  - `meta` object, required
    - `requestId` string, required: Echoed in the x-request-id header. Quote it in a bug report.

## Other responses

- `400`: `limit` is out of range.

---

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