Issue Card
POST
/api/v{{apiVersion}}/business/card/issue
IssueCardRequestDtoinitialBalance (double), cardBrand.ApiResponse<IssueCardResponse> — includes cardId, cardCustomerId, masked PAN/CVV where applicable, limits, etc.Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api-dev.usenumero.com/numeroaccount/api/v{{apiVersion}}/business/card/issue' \
--header '{{headerApiKeyName}}: {{businessApiKey}}' \
--header '{{headerSignatureName}}: {{requestSignature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"firstName": "Jane",
"lastName": "Doe",
"phone": "+2348012345678",
"address1": "10 Broad Street",
"address2": "Suite 2",
"city": "Lagos",
"state": "LA",
"zipcode": "101241",
"country": "NG",
"idNumber": "A12345678",
"idType": "PASSPORT",
"customerBvn": "22222222222",
"email": "jane@example.com",
"dateOfBirth": "1990-05-15T00:00:00",
"initialBalance": 5000,
"cardBrand": "VISA"
}'Response Response Example
200 - 200 — Card issued
{
"status": true,
"message": "Card issued successfully",
"code": "00",
"version": "v1",
"reference": "N2026032512001234",
"data": {
"cardCustomerId": "cust_7a8b9c0d1e",
"cardId": "card_mid_abc123",
"cardBrand": "VISA",
"cardClass": "virtual",
"cardNumber": "411111******1111",
"securityCode": "***",
"limitWindow": "monthly",
"expirationDate": "2028-12-31T00:00:00",
"expiration": "12/28",
"currencyCode": "NGN",
"firstSix": "411111",
"lastFour": "1111",
"status": "active",
"gatewayMerchantGuid": "550e8400-e29b-41d4-a716-446655440000",
"availableBalance": 5000,
"isPhysical": false
},
"error": null
}Modified at 2026-03-25 19:02:09