Skip to content

Get Card Plans ​

Get all active card plans with pricing and limits

Endpoint: GET https://api.uncash.io/api/v1/card-plans

Response ​

Success Response ​

FieldTypeDescription
successbooleanIndicates if the request was successful
messagestringSuccess message
dataarrayArray of available card plan objects

Card Plan Object ​

FieldTypeDescription
idintegerCard plan identifier
namestringCard plan name
descriptionstringCard plan description
limitnumberMaximum card balance limit
creation_feenumberFee charged to create this card plan
created_atstringISO 8601 timestamp

Request Example ​

bash
curl -X GET https://api.uncash.io/api/v1/card-plans \
  -H "Authorization: Bearer uc_your_api_token_here"
javascript
const response = await fetch('https://api.uncash.io/api/v1/card-plans', {
  headers: {
    'Authorization': 'Bearer uc_your_api_token_here'
  }
});

const data = await response.json();
python
import requests

url = "https://api.uncash.io/api/v1/card-plans"
headers = {"Authorization": "Bearer uc_your_api_token_here"}

response = requests.get(url, headers=headers)
data = response.json()

Response Example ​

json
{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Standard",
      "description": "Basic virtual card with standard features",
      "limit": 1000.00,
      "creation_fee": 5.00,
      "created_at": "2025-01-01T10:00:00.000Z"
    },
    {
      "id": 2,
      "name": "Premium",
      "description": "Premium virtual card with enhanced limits",
      "limit": 5000.00,
      "creation_fee": 10.00,
      "created_at": "2025-01-01T10:00:00.000Z"
    },
    {
      "id": 3,
      "name": "Business",
      "description": "Business virtual card with high limits",
      "limit": 25000.00,
      "creation_fee": 25.00,
      "created_at": "2025-01-01T10:00:00.000Z"
    }
  ],
  "message": "Card plans retrieved successfully"
}

Notes ​

Card Plan Selection: Choose the appropriate card plan based on your spending needs. Higher tier card plans have higher limits but also higher creation fees.

UnCash API Documentation