Get card

Early access - contact your account manager to enable card issuing for your platform.

Returns a card: its state, the masked card data (last4 and the expiry date), the cardholder, the card account and the spending limits. The full card number, CVC and PIN are never returned in plain text; see POST /baas/Cards/{id}/encrypted-envelope.

state is:

issuing - the card is being issued;

awaitingActivation - a physical card has been sent to the cardholder and must be activated;

active - the card can be used;

frozen - the card is temporarily frozen with the freeze endpoint; payments are declined until it is unfrozen;

blocked - Framnex has blocked the card, for example after a compliance review; payments are declined, and only Framnex can unblock the card;

rejected - the card could not be issued;

closed - the card is closed permanently.

For a blocked or rejected card, stateReason explains the state.

Returns 404 Not Found if the card does not exist or belongs to another integrator.

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "id": "0f8e2b6a-3c4d-4e5f-9a1b-7c2d3e4f5a6b",
    "externalId": "card-000123",
    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
    "cardProductId": "06776ac8-abe1-475b-92ee-72405c7b0e60",
    "cardholderId": "29de7042-59a4-4af9-acc9-c12b40cdf661",
    "cardholderName": "ANNA SCHMIDT",
    "cardName": "Marketing subscriptions",
    "type": "virtual",
    "network": "visa",
    "currency": "USD",
    "state": "issuing",
    "stateReason": null,
    "last4": "4821",
    "expirationMonth": 9,
    "expirationYear": 2029,
    "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
    "limits": [
        {
            "amount": 1000,
            "interval": "perAuthorization"
        }
    ],
    "shipping": {
        "address": {
            "streetLine1": "string",
            "streetLine2": "string",
            "city": "string",
            "state": "string",
            "zip": "string",
            "country": "string"
        },
        "recipientName": "Anna Schmidt",
        "phoneNumber": "+4930123456789"
    },
    "createdAt": "2026-09-29T10:00:00Z"
}

🟠400Bad Request

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Request

Request Code Samples

Responses