Skip to main content
POST
Block card

Authorizations

Authorization
string
header
required

API key as Bearer token

Headers

Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Path Parameters

id
string<uuid>
required

Response

Card resource

id
string<uuid>
required

Unique card identifier

accountId
string<uuid>
required

ID of the account the card belongs to

userId
string<uuid>
required

ID of the user the card belongs to

type
enum<string>
required

Card type (VIRTUAL or PHYSICAL)

Available options:
VIRTUAL,
PHYSICAL
Example:

"VIRTUAL"

status
enum<string>
required

Current card status

Available options:
ACTIVE,
FROZEN,
BLOCKED,
EXPIRED
Example:

"ACTIVE"

blockReason
CardBlockReason · object | null
required

Block reason details (only present when status is BLOCKED)

blockLiftable
boolean
required

Whether the current block can be lifted with the unblock endpoint. false for blocks that need Reap support, and for a card that holds no block.

frozen
boolean
required

Whether the card is frozen. A block hides a freeze from status, so a card that is BLOCKED with frozen: true returns to FROZEN once the block lifts.

cardholderName
string
required

Cardholder name displayed on card

last4
string
required

Last 4 digits of the card number. Use reveal endpoint for full details.

3dsChallengeMethod
enum<string>
required

3DS challenge verification method

Available options:
SMS,
WEBHOOK
Example:

"SMS"

physicalCardStatus
enum<string> | null
required

Physical lifecycle of the card (production + shipping + activation rollup). Defaults to NOT_ORDERED for newly created physical cards. null for virtual cards, which have no physical lifecycle.

Available options:
NOT_ORDERED,
REQUESTED,
IN_PRODUCTION,
PRODUCTION_COMPLETED,
IN_TRANSIT,
OUT_FOR_DELIVERY,
DELIVERED,
ACTIVATED,
CANCELED,
DELIVERY_FAILED,
EXCEPTION
Example:

"NOT_ORDERED"

createdAt
string
required

ISO 8601 timestamp of creation

updatedAt
string
required

ISO 8601 timestamp of last update