curl https://services-staging.getplu.com/api/v1/partner/card/acme-card-xyz789jkl012mno \
-H "Authorization: Bearer sk_staging_your_api_key"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/acme-card-xyz789jkl012mno',
{
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
},
}
);
{
"status": "success",
"message": "Card retrieved",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"serviceId": "acme-user-abc123def456ghi",
"cardName": "Jane Doe",
"cardCurrency": "USD",
"cardNumber": "4000123456789012",
"cardCvv": "123",
"cardExpiry": "12/27",
"status": "active",
"first6": "400012",
"last4": "9012",
"availableBalance": 50,
"ledgerBalance": 50,
"cardType": "virtual",
"cardProgram": "custodial",
"fundingType": "float",
"address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2025-01-15T10:30:00.000Z"
}
}
{
"status": "success",
"message": "Card retrieved",
"data": {
"serviceCardId": "acme-card-abc123def456ghi",
"serviceId": "acme-user-abc123def456ghi",
"cardName": "Jane Doe",
"cardCurrency": "USD",
"cardNumber": "4000123456789012",
"cardCvv": "123",
"cardExpiry": "12/27",
"status": "active",
"first6": "400012",
"last4": "9012",
"availableBalance": 120,
"ledgerBalance": 120,
"cardType": "virtual",
"cardProgram": "custodial",
"fundingType": "crypto",
"depositAddress": "0xFe3E1AD10Ae3ed07Dd79deb3E20E6118dEcE6904",
"supportedNetworks": [
{ "chain": "base-sepolia", "chainId": 84532, "tokens": ["usdc"] },
{ "chain": "polygon-amoy", "chainId": 80002, "tokens": ["usdc"] },
{ "chain": "optimism-sepolia", "chainId": 11155420, "tokens": ["usdc"] }
],
"address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2025-01-15T10:30:00.000Z"
}
}
{
"status": "error",
"message": "CARD_NOT_FOUND",
"data": {
"error": "Card not found"
}
}
Cards
Get Card
Retrieve details of a specific card
GET
/
v1
/
partner
/
card
/
{serviceCardId}
curl https://services-staging.getplu.com/api/v1/partner/card/acme-card-xyz789jkl012mno \
-H "Authorization: Bearer sk_staging_your_api_key"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/acme-card-xyz789jkl012mno',
{
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
},
}
);
{
"status": "success",
"message": "Card retrieved",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"serviceId": "acme-user-abc123def456ghi",
"cardName": "Jane Doe",
"cardCurrency": "USD",
"cardNumber": "4000123456789012",
"cardCvv": "123",
"cardExpiry": "12/27",
"status": "active",
"first6": "400012",
"last4": "9012",
"availableBalance": 50,
"ledgerBalance": 50,
"cardType": "virtual",
"cardProgram": "custodial",
"fundingType": "float",
"address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2025-01-15T10:30:00.000Z"
}
}
{
"status": "success",
"message": "Card retrieved",
"data": {
"serviceCardId": "acme-card-abc123def456ghi",
"serviceId": "acme-user-abc123def456ghi",
"cardName": "Jane Doe",
"cardCurrency": "USD",
"cardNumber": "4000123456789012",
"cardCvv": "123",
"cardExpiry": "12/27",
"status": "active",
"first6": "400012",
"last4": "9012",
"availableBalance": 120,
"ledgerBalance": 120,
"cardType": "virtual",
"cardProgram": "custodial",
"fundingType": "crypto",
"depositAddress": "0xFe3E1AD10Ae3ed07Dd79deb3E20E6118dEcE6904",
"supportedNetworks": [
{ "chain": "base-sepolia", "chainId": 84532, "tokens": ["usdc"] },
{ "chain": "polygon-amoy", "chainId": 80002, "tokens": ["usdc"] },
{ "chain": "optimism-sepolia", "chainId": 11155420, "tokens": ["usdc"] }
],
"address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2025-01-15T10:30:00.000Z"
}
}
{
"status": "error",
"message": "CARD_NOT_FOUND",
"data": {
"error": "Card not found"
}
}
Returns full card details including card number, CVV, expiry, balance, and status.
string
required
Bearer token. Example:
Bearer sk_staging_your_api_keystring
required
The card’s service ID.
curl https://services-staging.getplu.com/api/v1/partner/card/acme-card-xyz789jkl012mno \
-H "Authorization: Bearer sk_staging_your_api_key"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/acme-card-xyz789jkl012mno',
{
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
},
}
);
{
"status": "success",
"message": "Card retrieved",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"serviceId": "acme-user-abc123def456ghi",
"cardName": "Jane Doe",
"cardCurrency": "USD",
"cardNumber": "4000123456789012",
"cardCvv": "123",
"cardExpiry": "12/27",
"status": "active",
"first6": "400012",
"last4": "9012",
"availableBalance": 50,
"ledgerBalance": 50,
"cardType": "virtual",
"cardProgram": "custodial",
"fundingType": "float",
"address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2025-01-15T10:30:00.000Z"
}
}
{
"status": "success",
"message": "Card retrieved",
"data": {
"serviceCardId": "acme-card-abc123def456ghi",
"serviceId": "acme-user-abc123def456ghi",
"cardName": "Jane Doe",
"cardCurrency": "USD",
"cardNumber": "4000123456789012",
"cardCvv": "123",
"cardExpiry": "12/27",
"status": "active",
"first6": "400012",
"last4": "9012",
"availableBalance": 120,
"ledgerBalance": 120,
"cardType": "virtual",
"cardProgram": "custodial",
"fundingType": "crypto",
"depositAddress": "0xFe3E1AD10Ae3ed07Dd79deb3E20E6118dEcE6904",
"supportedNetworks": [
{ "chain": "base-sepolia", "chainId": 84532, "tokens": ["usdc"] },
{ "chain": "polygon-amoy", "chainId": 80002, "tokens": ["usdc"] },
{ "chain": "optimism-sepolia", "chainId": 11155420, "tokens": ["usdc"] }
],
"address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"country": "US"
},
"createdAt": "2025-01-15T10:30:00.000Z"
}
}
{
"status": "error",
"message": "CARD_NOT_FOUND",
"data": {
"error": "Card not found"
}
}
The response includes sensitive card data (full card number, CVV). Handle this data securely and never log or store it in plaintext. Consider PCI DSS compliance requirements.
depositAddress and supportedNetworks are present only on crypto cards. supportedNetworks lists every
chain/token pair that will be credited — read it at runtime rather than hardcoding a chain, since the values
differ between staging and production. See Supported networks.⌘I