List Transactions - Manastore API

List Transactions

GET /api/v1/transactions Returns every movement on your wallets, one row per movement, with the wallet balance right after it. Use it to reconcile top-ups, order payments and refunds against your own records. Uses the read_wallets permission, which every API key already has, so you don’t need a new key.

Query Parameters

Parameter	Type	Default	Description
`wallet_id`	string	—	Only transactions for this wallet (from List Wallets)
`start_date`	date	—	Only transactions on or after this date, e.g. `2026-10-01` (UTC, inclusive)
`end_date`	date	—	Only transactions on or before this date, e.g. `2026-10-31` (UTC, inclusive)
`sort`	string	`desc`	`asc` for oldest first, `desc` for newest first
`per_page`	integer	15	Number of items per page (max: 100)
`page`	integer	1	Page number

For a full period, use start_date, end_date and sort=asc, then follow links.next until it is null.

curl "https://api.manastore.com/api/v1/transactions?start_date=2026-10-01&end_date=2026-10-31&sort=asc&per_page=100" \
  -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json"

Responses

Status	Description
`200 OK`	Successful operation
`401 Unauthorized`	Missing or invalid authentication token
`403 Forbidden`	Access denied
`422 Unprocessable Entity`	Invalid filter, e.g. `end_date` before `start_date` or a `wallet_id` that isn’t yours

Example Response

{
  "data": [
    {
      "id": "01J9Z3P7H4N2QW8E5RT6YU1IOA",
      "wallet_id": "01J9Z3MXQ2W4RTB6YH8KCN5VDE",
      "type": "deposit",
      "status": "completed",
      "description": "Deposit approved",
      "currency": "USD",
      "amount": {
        "amount": "15000000",
        "currency": "USD",
        "formatted": "$150,000.00",
        "decimal": "150000.00",
        "localized_decimal": "150000.00"
      },
      "balance_after": {
        "amount": "15012250",
        "currency": "USD",
        "formatted": "$150,122.50",
        "decimal": "150122.50",
        "localized_decimal": "150122.50"
      },
      "order": null,
      "deposit": {
        "id": 87,
        "reference": "INV-2026-0011"
      },
      "created_at": "2026-09-30T09:15:00+00:00"
    },
    {
      "id": "01J9Z3NDF0RXKQ5V3Q8M2B7C1D",
      "wallet_id": "01J9Z3MXQ2W4RTB6YH8KCN5VDE",
      "type": "orderPayment",
      "status": "completed",
      "description": "Order payment",
      "currency": "USD",
      "amount": {
        "amount": "-4426",
        "currency": "USD",
        "formatted": "-$44.26",
        "decimal": "-44.26",
        "localized_decimal": "-44.26"
      },
      "balance_after": {
        "amount": "15007824",
        "currency": "USD",
        "formatted": "$150,078.24",
        "decimal": "150078.24",
        "localized_decimal": "150078.24"
      },
      "order": {
        "ulid": "01J9Z3NDEKTSV4RRFFQ69G5FAV",
        "order_number": "#12345"
      },
      "deposit": null,
      "created_at": "2026-10-01T12:00:00+00:00"
    },
    {
      "id": "01J9Z3QA6B8C2D4E6F8G0H2J4K",
      "wallet_id": "01J9Z3MXQ2W4RTB6YH8KCN5VDE",
      "type": "creditAdjustment",
      "status": "completed",
      "description": "Admin adjustment: Refund for order #12345 (PlayStation Network Card $25 USA x1), code was faulty",
      "currency": "USD",
      "amount": {
        "amount": "2213",
        "currency": "USD",
        "formatted": "$22.13",
        "decimal": "22.13",
        "localized_decimal": "22.13"
      },
      "balance_after": {
        "amount": "15010037",
        "currency": "USD",
        "formatted": "$150,100.37",
        "decimal": "150100.37",
        "localized_decimal": "150100.37"
      },
      "order": null,
      "deposit": null,
      "created_at": "2026-10-01T14:30:00+00:00"
    }
  ],
  "links": {
    "first": "https://api.manastore.com/api/v1/transactions?page=1",
    "last": "https://api.manastore.com/api/v1/transactions?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://api.manastore.com/api/v1/transactions",
    "per_page": 100,
    "to": 3,
    "total": 3
  }
}

Fields

Field	Description
`id`	Transaction id. For order payments this equals the order’s `transaction_id`.
`type`	`deposit` (top-up), `orderPayment`, `creditAdjustment` (e.g. a refund), `debitAdjustment`, `withdraw`
`description`	For adjustments this says what it was for, e.g. which order a refund belongs to
`amount`	Signed: negative when money leaves the wallet. See Money Values.
`balance_after`	Wallet balance right after this transaction
`order`	Set for order payments: the order’s `ulid` and `order_number`
`deposit`	Set for deposits: our deposit `id` and the `reference` you entered when submitting the deposit
`created_at`	When the transaction happened (UTC)