Logo PopinaPopina API

List customer movements

List customer movements at current location.

GET/v1/customers/{customerId}/movements
authorization<token>

Use device JWT token

In: header

Path Parameters

customerIdstring

Customer UUID

Formatuuid

Query Parameters

type?string
Value in"deposit" | "withdrawal" | "purchase" | "refund"
index?integer

Index of the page query parameter

Default0
Range0 <= value
size?integer

Number of record on a page query parameter (capped to 100)

Default10
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "http://localhost:4012/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08/movements"
{
  "data": [
    {
      "id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "type": "deposit",
      "createdAt": "2025-10-28T10:00:00.000Z",
      "updatedAt": "2025-10-28T10:00:00.000Z",
      "totalOrder": 0,
      "amount": 5000,
      "updatedBalance": 5000,
      "currencyCode": "EUR",
      "status": "pending",
      "description": "Deposit from cash"
    },
    {
      "id": "b2c3d4e5-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
      "type": "purchase",
      "createdAt": "2025-10-28T11:30:00.000Z",
      "updatedAt": "2025-10-28T11:30:00.000Z",
      "totalOrder": 2500,
      "amount": -2500,
      "updatedBalance": 2500,
      "currencyCode": "EUR",
      "status": "pending",
      "description": "Purchase from order"
    }
  ],
  "meta": {
    "totalPage": 5,
    "totalCount": 25,
    "currentPageIndex": 0,
    "pageSize": 50,
    "hiddenByFilterCount": 5
  },
  "links": {
    "self": "http://localhost/v1/customers/:customerId/movements?size=50&index=0",
    "first": "http://localhost/v1/customers/:customerId/movements?size=50&index=0",
    "last": "http://localhost/v1/customers/:customerId/movements?size=50&index=4",
    "next": "http://localhost/v1/customers/:customerId/movements?size=50&index=1",
    "prev": null
  }
}
{
  "message": "Customer not found",
  "code": "CUSTOMER_NOT_FOUND"
}
{
  "message": "Customer not found",
  "code": "CUSTOMER_NOT_FOUND"
}