m2pfintech
API LibraryForex Issuance

Filter Forex Issuances by Criteria

Advanced search for forex issuances using multiple filter criteria such as date range, status, hierarchy, product, and custom fields. Supports pagination.

POST
/v1/forex/issuance/filter/fetch-by-criteria

Authorization

bearerAuth tenantId
AuthorizationBearer <token>

In: header

X-TENANT-ID<token>

In: header

Query Parameters

pageNo?integer
Default0
pageSize?integer
Default10

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Request Body

application/json

filters?
sortField?string

Field to sort by

sortOrder?string
Value in"ASC" | "DESC"

Response Body

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/issuance/filter/fetch-by-criteria" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "filters": [      {        "field": "currentStatus",        "operator": "EQUALS",        "value": "APPROVED"      }    ],    "sortField": "createdDate",    "sortOrder": "DESC"  }'
{
  "result": {},
  "pagination": {}
}
{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Bad Request",
  "status": 400,
  "detail": "Unable to convert http message",
  "message": "error.http.400"
}

Fetch Forex Issuances by Status and Issuer GET

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 |

Fetch and Update Forex Exchange Rates POST

Fetches the latest forex exchange rates from upstream rate providers and updates the platform's internal rate cache. Returns the current rates after refresh. ### When to Use - Periodic rate refresh (typically called by an internal scheduler) - Manual rate refresh when rates appear stale - Before a batch of issuances to ensure fresh rates