Card status

Card details

After issuance, fetch the card by cardId.

GET /cards/CARD_ID

curl -s "https://b2b-api.easyonramp.com/api/v1/cards/CARD_ID" \
  -H "Authorization: Bearer YOUR_JWT"

Card details response

{
  "id": "card-uuid",
  "status": "active",
  "last4": "4242",
  "displayName": "Jane Doe Card",
  "cardType": "virtual",
  "expirationMonth": "12",
  "expirationYear": "2028",
  "isPinSet": false
}

Card status changes

Use either approach. You do not need both. Option A: Poll GET /cards/{cardId} until status is active (or frozen or terminated after lifecycle actions). See Rate limits if polling. Option B: Subscribe to webhooks. See Card status (card.status.*).

Card statuses

Status	Meaning
pending	Provisioning in progress
active	Card can be used (default after issuance)
frozen	Temporarily blocked. See Lifecycle controls
terminated	Permanently deleted via `DELETE /cards/{cardId}`

Enrollment status

If the card is not yet issued, check the user’s EasyCard enrollment. Use either approach. You do not need both. Option A: Poll GET /cards/users/{userId}/enroll until status is approved (or rejected). See Rate limits if polling.

GET /cards/users/USER_ID/enroll

curl -s "https://b2b-api.easyonramp.com/api/v1/cards/users/USER_ID/enroll" \
  -H "Authorization: Bearer YOUR_JWT"

Enrollment status response

{
  "id": "507f1f77bcf86cd799439013",
  "status": "needs_verification",
  "rainCardholderId": "cardholder-uuid"
}

Option B: Subscribe to webhooks. See Card enrollment (card.enrollment.*).

Get started

Core concepts

Common workflows

How to manage users

How to fund your business wallet

How to use cards

How to use reports

Integration services

Card details

Card status changes

Card statuses

Enrollment status

​Card details

​Card status changes

​Card statuses

​Enrollment status

​Related

Card details

Card status changes

Card statuses

Enrollment status

Related