POST
/transactions/user/{userId}Search Transactions
Returns a paginated list of transactions for a specific user. Supports filtering by date range, authorization status, direction, and free-text search across transaction number, from/to names, and description.
Path variables
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
userId | string | Required | — | Unique user ID. |
Headers
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
session-token | string | Required | — | SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header. |
Request body
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
PageNumber | integer | Optional | — | Page number (enter 1 for the first page, 2 for the second, etc.). |
PageSize | integer | Optional | 10 | 20 | 50 | Number of records to return per page must be an integer between 1 and 100. |
FromDate | string | Optional | YYYY-MM-DD | Start date filter (ISO 8601). |
ToDate | string | Optional | YYYY-MM-DD | End date filter (ISO 8601). |
AuthorizationStatuses | array | Optional | pending | denied | canceled | expired | authorized | Filter by authorization status. |
Direction | string | Optional | credit | debit | Filter by transaction direction. |
SearchText | string | Optional | — | Free-text search across transaction number, from name, to name, and description. |
Example request
{
"PageNumber": 1,
"PageSize": 20,
"FromDate": "2026-04-01",
"ToDate": "2026-05-28",
"AuthorizationStatuses": [
"authorized"
],
"Direction": "credit",
"SearchText": "<username|transaction number|description>"
}All body fields are optional. Update the sample with valid values (for example date range, `AuthorizationStatuses`, `Direction`, and `SearchText`) to filter results and see the matching response. `SearchText` matches transaction number, from/to names, and description.
Response
| Field | Type | Possible values | Description |
|---|---|---|---|
ResponseCode | integer | 200 | 201 | 204 | 301 | 400 | 401 | 403 | 404 | 410 | 422 | 500 | 503 | API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized). |
ResponseMessage | string | Success | Created | NoContent | BadRequest | Unauthorized | Forbidden | NotFound | Gone | UnprocessableContent | ServerError | ResourceMoved | ServiceUnAvailable | UnProcessableEntity | Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome. |
ResponseData | object | Please refer to below example for response body | Paginated list of transactions for the specified user. |
Example response
{
"ResponseCode": 200,
"ResponseMessage": "Success",
"ResponseData": {
"CurrentPage": 1,
"PageSize": 20,
"TotalCount": 691,
"Data": [
{
"TransactionNumber": "FV000726664",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "100.00",
"Description": "Test",
"Date": "2026-06-23T10:00:14.210Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - FV Net"
},
{
"TransactionNumber": "FV000726663",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "100.00",
"Description": "Test API",
"Date": "2026-06-23T09:55:29.603Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Domestic (ACH)"
},
{
"TransactionNumber": "FV000726662",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "100.00",
"Description": "Test API",
"Date": "2026-06-23T09:53:48.773Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Domestic Wire"
},
{
"TransactionNumber": "FV000726661",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "100.00",
"Description": "Test API",
"Date": "2026-06-23T09:52:00.947Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - International Wire"
},
{
"TransactionNumber": "FV000726658",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "30.00",
"Description": null,
"Date": "2026-06-23T07:25:36.887Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Domestic Wire"
},
{
"TransactionNumber": "FV000726657",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "50.00",
"Description": "Test",
"Date": "2026-06-23T06:49:06.409Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Domestic (ACH)"
},
{
"TransactionNumber": "FV000726656",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "11.09",
"Description": "test",
"Date": "2026-06-23T05:01:05.488Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - AED Domestic Payments"
},
{
"TransactionNumber": "FV000726650",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "40.00",
"Description": "test",
"Date": "2026-06-16T13:10:42.334Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - FV Net"
},
{
"TransactionNumber": "FV000726648",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "30.00",
"Description": "test",
"Date": "2026-06-16T12:48:05.579Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - FV Net"
},
{
"TransactionNumber": "FV000726647",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T08:20:30.858Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726646",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T08:15:01.774Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726645",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T08:09:32.653Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726644",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T08:06:09.781Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726643",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T07:58:48.324Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726642",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T07:53:53.620Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726636",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T07:37:07.716Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726624",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T07:16:55.085Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726593",
"Subclass": "PAYMENT",
"AuthorizationStatus": "AUTHORIZED",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T05:56:44.007Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726592",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "2.96",
"Description": "tester",
"Date": "2026-06-15T05:50:51.883Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
},
{
"TransactionNumber": "FV000726587",
"Subclass": null,
"AuthorizationStatus": "PENDING_AUTHORIZATION",
"Amount": "2.96",
"Description": "MXN payment test",
"Date": "2026-06-15T05:37:29.541Z",
"Customer": "John Doe",
"TransferFee": "0.00",
"Direction": "debit",
"DisplayTransferType": "Payment - Cross Border - Clabe"
}
]
}
}Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.