List transactions for your account with filtering by time range, payment method, and status. Supports pagination.

Example Request

# Last 7 days, completed transactions only
curl "https://api.neutron.me/api/v2/transaction?time=7d&txnStatuses=completed&limit=20&page=1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Query Parameters

Parameter	Type	Description
`time`	string	Time range: `1d`, `7d`, `30d`, `3m`, `6m`, `1y`, or `other`
`startTime`	string	ISO timestamp — only used when `time=other`
`endTime`	string	ISO timestamp — only used when `time=other`
`txnStatuses`	string	Filter by state (e.g., `completed`, `quoted`, `failed`)
`srcMethods`	string	Filter by source method (e.g., `lightning`, `neutronpay`)
`destMethods`	string	Filter by destination method
`excludedSrcMethods`	string	Exclude specific source methods
`excludedDestMethods`	string	Exclude specific destination methods
`limit`	number	Results per page
`page`	number	Page number

Custom Date Range

To use a specific date range, set time=other with startTime and endTime:

curl "https://api.neutron.me/api/v2/transaction?time=other&startTime=2026-02-01T00:00:00Z&endTime=2026-02-08T23:59:59Z" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

⚠️
When time is set to anything other than other, the startTime and endTime parameters are ignored.

Filter Examples

# All Lightning receives in the last 30 days
?time=30d&srcMethods=lightning

# Failed on-chain sends
?time=7d&destMethods=on-chain&txnStatuses=failed

# Everything except internal swaps
?time=30d&excludedSrcMethods=neutronpay&excludedDestMethods=neutronpay

Example Response

{
  "data": [
    {
      "txnId": "5e25d2f4-9bca-4b7a-a1ad-2cf056100cb6",
      "accountId": "ne01-abc123def456",
      "txnState": "completed",
      "sourceReq": {
        "ccy": "BTC",
        "method": "lightning",
        "amtRequested": 0.0001,
        "amtSettled": 0.0001
      },
      "destReq": {
        "ccy": "BTC",
        "method": "neutronpay",
        "amtRequested": 0.0001,
        "amtSettled": 0.0001
      },
      "fxRate": 1,
      "createdAt": 1770342000000
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 145
  }
}

Related

Get transaction status — Get a single transaction's details
Transaction Status Types — All states explained
Webhook Guide — Get real-time notifications instead of polling