API LibraryForex Issuance
Fetch Forex Issuances by Status and Issuer
Retrieves a paginated list of forex issuances filtered by the issuing hierarchy ID and current status. Useful for operational dashboards and approval queues.
Common Status Values
| Status | Description |
|---|---|
CREATED | Pending maker-checker approval |
APPROVED | Approved and processed |
REJECTED | Rejected by checker |
FAILED | Processing failed after approval |
Authorization
bearerAuth tenantId AuthorizationBearer <token>
In: header
X-TENANT-ID<token>
In: header
Path Parameters
id*string
Hierarchy ID (corporate or branch)
status*string
Issuance status filter
Value in
"CREATED" | "APPROVED" | "REJECTED" | "FAILED"Query Parameters
pageNo?integer
Page number (0-indexed)
Default
0Header Parameters
X-TENANT-ID*string
Your unique tenant identifier
Response Body
application/json
application/json
curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/issuance/fetch-by-status-issued-by/90009/CREATED" \ -H "X-TENANT-ID: ACME_CORP"{
"result": {},
"pagination": {}
}{
"type": "https://www.m2pfintech.com/problem/problem-with-message",
"title": "Business validation failed",
"status": 409,
"detail": "Business validation failed",
"message": "error.business",
"businessCode": "PP_CORP_002"
}Fetch Forex Issuance by ID GET
Retrieves the complete details of a forex issuance by its unique ID, including customer details, wallet loads, fee breakdown, trip information, and approval status.
Filter Forex Issuances by Criteria POST
Advanced search for forex issuances using multiple filter criteria such as date range, status, hierarchy, product, and custom fields. Supports pagination.