List transactions

Time	Status	User Agent
Retrieving recent requests…

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
  }
}

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

List transactions

Example Request

Query Parameters

Custom Date Range

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

Filter Examples

Example Response

Related

Example Request

Query Parameters

Custom Date Range

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

Filter Examples

Example Response

Related

200

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