{
  "info": {
    "name": "CardAPI",
    "description": "Complete collection for the CardAPI REST API — credit card data for the US and Canada. Set the `api_key` variable to your CardAPI key before use.\n\nSDKs available: npm install @cardapi/client (https://www.npmjs.com/package/@cardapi/client) | pip install cardapi (https://pypi.org/project/cardapi/)",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "cardapi-v1-collection"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://adaptable-dream-production-2fce.up.railway.app",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "YOUR_API_KEY",
      "type": "string"
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Cards",
      "item": [
        {
          "name": "List Cards",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards"],
              "query": [
                { "key": "issuer", "value": "", "description": "Filter by issuer slug (e.g. chase, amex)", "disabled": true },
                { "key": "country", "value": "", "description": "Filter by country code: US or CA", "disabled": true },
                { "key": "category", "value": "", "description": "Filter by reward category (e.g. dining, groceries)", "disabled": true },
                { "key": "limit", "value": "25", "description": "Results per page (default: 25, max: 100)", "disabled": true },
                { "key": "offset", "value": "0", "description": "Pagination offset", "disabled": true }
              ]
            },
            "description": "List all credit cards. Returns paginated results with basic card information."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"amex-gold\",\n      \"name\": \"American Express Gold Card\",\n      \"issuer\": \"amex\",\n      \"network\": \"amex\",\n      \"annual_fee\": 250,\n      \"country\": \"US\",\n      \"url\": \"/v1/cards/amex-gold\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 192,\n    \"limit\": 25,\n    \"offset\": 0\n  }\n}"
            }
          ]
        },
        {
          "name": "Get Card",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards/amex-gold",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards", "amex-gold"]
            },
            "description": "Get full details for a single card including reward rates, benefits, and signup bonus."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": {\n    \"id\": \"amex-gold\",\n    \"name\": \"American Express Gold Card\",\n    \"issuer\": \"amex\",\n    \"annual_fee\": 250,\n    \"signup_bonus\": {\n      \"amount\": \"60,000\",\n      \"currency\": \"MR points\",\n      \"spend_requirement\": 6000,\n      \"time_period_months\": 6\n    },\n    \"reward_rates\": [\n      { \"category\": \"dining\", \"rate\": 4, \"type\": \"multiplier\" },\n      { \"category\": \"groceries\", \"rate\": 4, \"type\": \"multiplier\", \"cap\": 25000 }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Card Change History",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards/amex-gold/history",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards", "amex-gold", "history"]
            },
            "description": "Get the change history for a card (signup bonus changes, fee changes, etc.)."
          },
          "response": []
        },
        {
          "name": "Card Transfer Partners",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards/amex-gold/transfers",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards", "amex-gold", "transfers"]
            },
            "description": "Get the transfer partners available for a specific card."
          },
          "response": []
        },
        {
          "name": "Search Cards",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards/search?q=sapphire",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards", "search"],
              "query": [
                { "key": "q", "value": "sapphire", "description": "Search term — matched against card name and issuer" }
              ]
            },
            "description": "Search cards by name or issuer."
          },
          "response": []
        },
        {
          "name": "Compare Cards",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards/compare?slugs=amex-gold,chase-sapphire-preferred",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards", "compare"],
              "query": [
                { "key": "slugs", "value": "amex-gold,chase-sapphire-preferred", "description": "Comma-separated list of card slugs to compare" }
              ]
            },
            "description": "Side-by-side comparison of multiple cards."
          },
          "response": []
        },
        {
          "name": "Best Cards by Category",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/cards/best?category=dining&country=US",
              "host": ["{{base_url}}"],
              "path": ["v1", "cards", "best"],
              "query": [
                { "key": "category", "value": "dining", "description": "Spending category (dining, groceries, gas, travel, etc.)" },
                { "key": "country", "value": "US", "description": "Country code: US or CA", "disabled": true },
                { "key": "limit", "value": "10", "description": "Number of results (default: 10)", "disabled": true }
              ]
            },
            "description": "Get cards ranked by reward rate for a given spending category."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Issuers",
      "item": [
        {
          "name": "List Issuers",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/issuers",
              "host": ["{{base_url}}"],
              "path": ["v1", "issuers"]
            },
            "description": "List all 22 supported card issuers with card counts."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": [\n    { \"id\": \"chase\", \"name\": \"Chase\", \"country\": \"US\", \"card_count\": 45 },\n    { \"id\": \"amex\", \"name\": \"American Express\", \"country\": \"US\", \"card_count\": 38 }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get Issuer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/issuers/chase",
              "host": ["{{base_url}}"],
              "path": ["v1", "issuers", "chase"]
            },
            "description": "Get details for a specific issuer including all their cards."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Categories",
      "item": [
        {
          "name": "List Categories",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/categories",
              "host": ["{{base_url}}"],
              "path": ["v1", "categories"]
            },
            "description": "List all spending categories tracked by CardAPI. Use these slugs when querying reward rates."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": [\n    { \"id\": \"dining\", \"name\": \"Dining\", \"description\": \"Restaurants, bars, cafes\" },\n    { \"id\": \"groceries\", \"name\": \"Groceries\", \"description\": \"Supermarkets, grocery stores\" },\n    { \"id\": \"gas\", \"name\": \"Gas\", \"description\": \"Gas stations, EV charging\" },\n    { \"id\": \"travel\", \"name\": \"Travel\", \"description\": \"Hotels, flights, car rentals\" }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Transfer Partners",
      "item": [
        {
          "name": "List Transfer Partners",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/transfer-partners",
              "host": ["{{base_url}}"],
              "path": ["v1", "transfer-partners"],
              "query": [
                { "key": "card_id", "value": "", "description": "Filter by card slug", "disabled": true },
                { "key": "program", "value": "", "description": "Filter by loyalty program (e.g. aeroplan, hyatt)", "disabled": true }
              ]
            },
            "description": "List all loyalty program transfer partners with transfer ratios."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": [\n    {\n      \"from_program\": \"Amex Membership Rewards\",\n      \"to_program\": \"Aeroplan\",\n      \"ratio\": \"1:1\",\n      \"transfer_time\": \"instant\",\n      \"cards\": [\"amex-gold\", \"amex-platinum\"]\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Application Rules",
      "item": [
        {
          "name": "List Application Rules",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/application-rules",
              "host": ["{{base_url}}"],
              "path": ["v1", "application-rules"],
              "query": [
                { "key": "issuer", "value": "", "description": "Filter by issuer slug", "disabled": true }
              ]
            },
            "description": "List all known application rules and restrictions by issuer. Includes velocity limits, lifetime rules, and product change restrictions."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": [\n    {\n      \"issuer\": \"chase\",\n      \"rule\": \"5/24\",\n      \"description\": \"Cannot be approved if you have opened 5+ new credit cards in the last 24 months\",\n      \"applies_to\": \"all personal cards\"\n    },\n    {\n      \"issuer\": \"amex\",\n      \"rule\": \"once-per-lifetime\",\n      \"description\": \"Signup bonus is limited to once per lifetime per card product\",\n      \"applies_to\": \"all cards with signup bonus\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Auth",
      "item": [
        {
          "name": "Check Usage",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/auth/usage",
              "host": ["{{base_url}}"],
              "path": ["v1", "auth", "usage"]
            },
            "description": "Check current usage and rate limit status for your API key."
          },
          "response": [
            {
              "name": "200 OK",
              "status": "OK",
              "code": 200,
              "body": "{\n  \"data\": {\n    \"daily_used\": 42,\n    \"daily_limit\": 100,\n    \"monthly_used\": 310,\n    \"monthly_limit\": 3000,\n    \"tier\": \"free\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Get Stats",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/stats",
              "host": ["{{base_url}}"],
              "path": ["v1", "stats"]
            },
            "description": "Get database stats: total cards, issuers, last updated."
          },
          "response": []
        },
        {
          "name": "Notable Offers",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/offers/notable",
              "host": ["{{base_url}}"],
              "path": ["v1", "offers", "notable"]
            },
            "description": "Get recent notable offer changes (elevated bonuses, fee changes, etc.)."
          },
          "response": []
        }
      ]
    }
  ]
}