# Transaction history

`GET /service/@id/tinopay/transactions` · TinoPay, service owner's sign-in token

Newest first, with fields named like the webhook payload (`transactionDate` in ISO 8601). Filters: `bank_account_id`, `virtual_account` (exact VA number), `type` (`in`, `out`), `from`, `to` (`Y-m-d`, by transaction date), `q` (description, transaction code, VA number, reference code), `webhook_status` (`none` not sent, `failed`, `success`); paginated, `per_page` up to 100.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/tinopay/transactions` |
| Method | `GET` |
| Authentication | the TinoPay service owner's sign-in token (`Authorization: Bearer <token>`); the `/v1` gateway does not expose TinoPay yet |
| Content-Type | — (no body) |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | int | yes | TinoPay service ID |
| `bank_account_id` | query | string | — | — |
| `virtual_account` | query | string | — | Số VA chính xác |
| `type` | query | string | — | in \| out |
| `from` | query | string | — | Y-m-d |
| `to` | query | string | — | Y-m-d |
| `q` | query | string | — | Nội dung, mã giao dịch, số VA, mã tham chiếu |
| `webhook_status` | query | string | — | none \| failed \| success |
| `page` | query | int | — | — |
| `per_page` | query | int | — | ≤ 100 |

## Example request

```bash
curl "https://api.tino.vn/service/100001/tinopay/transactions" \
  -H "Authorization: Bearer $TINO_TOKEN"
```

`$TINO_TOKEN` is the TinoPay service owner's sign-in token. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): no dedicated function yet, use `client.request("GET", "/service/@id/tinopay/transactions")`.

## Example response

```json
{
 "data": [
  {
   "id": 98213,
   "transaction_id": "20261020083338000006",
   "bank_account_id": "9c1e6f2a-5b7d-4e1a-9f3c-2d8b6a4e0c11",
   "gateway": "BIDV",
   "accountNumber": "96240000001",
   "virtualAccount": "9624QA01",
   "content": "DH12345 chuyen tien mua hang",
   "transferType": "in",
   "transferAmount": 150000,
   "referenceCode": "0551dTCO-82LiomOss",
   "transactionDate": "2026-10-20T08:33:38+07:00",
   "created_at": "2026-10-20T08:33:40+07:00"
  }
 ],
 "meta": {
  "page": 1,
  "per_page": 20,
  "total": 1,
  "last_page": 1
 }
}
```

Sample built from the TinoPay API v1 documentation (Tino relays TinoPay data as is); values are examples.