Fetch Issuances by Hierarchy and Status
Narrows the status query to a specific hierarchy node (branch, sub-corporate, etc.). Useful when the partner portal needs to show issuance status per branch rather than across the entire tenant.
Server
Use the corporate server URLs for this endpoint.
Authorization
bearerAuth tenantId JWT Bearer token from the Authentication API
In: header
Your unique tenant identifier assigned during onboarding
In: header
Path Parameters
Hierarchy node ID (branch / sub-corporate)
Issuance status to filter by
"CREATED" | "PENDING_APPROVAL" | "APPROVED" | "REJECTED" | "SUCCESS" | "FAILED"Query Parameters
010Header Parameters
Your unique tenant identifier
Response Body
application/json
application/json
curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/middleware/v1/corporate-issuances/fetch-by-status-issued-by/qappv272jez0owws/SUCCESS" \ -H "X-TENANT-ID: ACME_CORP"{
"result": {},
"pagination": {
"list": true,
"pageSize": 0,
"pageNo": 0,
"totalPages": 0,
"totalElements": 0
}
}{
"type": "https://www.m2pfintech.com/problem/problem-with-message",
"title": "string",
"status": 0,
"detail": "string",
"message": "error.http.400",
"businessCode": "string",
"fieldErrors": [
{
"field": "string",
"message": "string"
}
],
"cause": {},
"errorCode": "string",
"errors": [
"string"
],
"languageCode": "string",
"localizedMessage": "string",
"suppressed": [
{}
]
}Fetch Issuance Details GET
Retrieves the full details of a single corporate issuance record by its internal ID. Use this to retrieve the exact status and beneficiary card details immediately after approval. ### Server Use the **corporate** server URLs for this endpoint.
Fetch Issuances by Status GET
Returns a paginated list of all corporate issuances in a specific status. This is the **primary status-tracking endpoint** for the partner portal — poll this after triggering a bulk issuance to check how many records have moved to `SUCCESS` or `FAILED`. ### Valid Status Values | Status | Meaning | |--------|---------| | `CREATED` | Maker submitted, awaiting checker approval | | `PENDING_APPROVAL` | In checker queue | | `APPROVED` | Checker approved, provisioning in progress | | `REJECTED` | Checker rejected | | `SUCCESS` | Cards fully provisioned and active | | `FAILED` | Provisioning failed (check `reason` field) | ### Bulk Tracking Pattern ``` GET /fetch-by-status/SUCCESS?pageNo=0&pageSize=100 → shows how many out of a bulk batch completed successfully GET /fetch-by-status/FAILED?pageNo=0&pageSize=100 → shows failed records with error reasons for retry ``` ### Server Use the **corporate** server URLs for this endpoint.