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