Skip to main content
GET
/
api
/
v1
/
transactions
/
user
Get all user transactions with pagination and filters
curl --request GET \
  --url https://api.dev.monei.cc/api/v1/transactions/user \
  --header 'X-API-KEY: <api-key>'
{
  "statusCode": 123,
  "message": "<string>",
  "data": {
    "transactions": [
      {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "deletedDate": "2023-11-07T05:31:56Z",
        "userId": "<string>",
        "amount": 123,
        "type": "<string>",
        "status": "<string>",
        "reference": "<string>",
        "narration": "<string>",
        "currency": "<string>"
      }
    ],
    "pagination": {
      "page": 123,
      "limit": 123,
      "total": 123,
      "totalPages": 123,
      "hasNextPage": true,
      "hasPreviousPage": true
    }
  },
  "errors": {}
}

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
page
number
default:1

Page number

​
limit
number
default:10

Items per page

​
status
enum<string>

Filter by transaction status

Available options:
PENDING,
SUCCESS,
FAILED,
COMPLETED
Example:

"SUCCESS"

​
type
enum<string>

Filter by transaction type

Available options:
DEBIT,
CREDIT,
PEER-TRANSFER
Example:

"CREDIT"

​
minAmount
number

Filter by minimum amount

​
maxAmount
number

Filter by maximum amount

​
currency
string

Filter by currency

​
narration
string

Filter by narration (contains text)

​
reference
string

Filter by reference

​
fincraReference
string

Filter by fincraReference

​
flutterwaveReference
string

Filter by flutterwaveReference

​
startDate
string

Start date for filtering (YYYY-MM-DD)

​
endDate
string

End date for filtering (YYYY-MM-DD)

​
sortBy
enum<string>
default:createdAt

Sort field

Available options:
createdAt,
amount,
updatedAt
​
sortOrder
enum<string>
default:desc

Sort direction: asc or desc

Available options:
asc,
desc

Response

Transactions retrieved successfully

​
statusCode
number
required
​
message
string
required
​
data
object
required
​
errors
object
required