API Endpoints

1. Home Page

GET

Returns the API home page

GET https://api.finckr.com/

2. List All Credit Cards

GET

Returns a list of all credit cards available

GET https://api.finckr.com/cards

Response Format: JSON array of card objects

Example Response 
[
  {
    "id": "3294",
    "name": "IDFC First Bank Mayura Credit Card",
    "slug": "idfc-first-bank-mayura-credit-card",
    "bank_id": "8280"
  },
  {
    "id": "8340",
    "name": "IDFC First Bank Ashva Metal Credit Card",
    "slug": "idfc-first-bank-ashva-metal-credit-card",
    "bank_id": "8280"
  }
]

3. Get Single Card Details

GET

Returns detailed information about a specific credit card

GET https://api.finckr.com/cards/{card_slug}

Parameters:

card_slug (string, required): The slug of the card (from the cards list)

Example Request 
GET https://api.finckr.com/cards/idfc-first-bank-ashva-metal-credit-card
Example Response 
{
  "name": "IDFC First Bank Ashva Metal Credit Card",
  "apply_link": "https://finckr.com/go/idfc-ashva",
  "rating": "(4.6/5)",
  "fees": {
    "Joining Fee": "2,999 + GST",
    "Renewal Fee": "2,999 + GST",
    "Best Suited For": "Travel | Shopping |",
    "Reward Type": "Reward Points |",
    "Welcome Benefits": "Bonus 2,500 Reward Points (625). 2,000 Cashback on Making Four Transactions of 500 or Above"
  },
  "rewards_and_benefits": {
    "Movie & Dining": "BOGO on Movie Ticket Bookings Upto 400 With BookMyShow, Twice Each Month (Annual Benefit - 9,600)",
    "Rewards Rate": "10X Reward Points/150 on Incremental Spends Above 20,000 Per Statement Cycle. 5X Reward Points/150 on Spends Upto 20,000. 3X RPs Are Also Awarded for Rent, Wallet Load, Education, and Government Transactions"
  },
  "fees_and_charges": {
    "Rewards Redemption Fee": "99 +GST",
    "Foreign Currency Markup": "1% on International Transactions",
    "Interest Rates": "Monthly Rate 0.75% to 3.65% and Annual Rate 9% to 43.8%"
  },
  "product_details": [
    "Ashva Credit Card is a rewarding card from IDFC First Bank. It is available in the metal variant.",
    "Free movie tickets worth 400 are offered on bookings made with BookMyShow."
  ],
  "pros_cons": {
    "pros": [
      "From domestic airports to international ones and even railway lounges across India, this card offers complimentary lounge access everywhere."
    ],
    "cons": [
      "To fully take advantage of this card, you would need to spend more than 20,000 each month."
    ]
  },
  "faqs": [
    {
      "question": "Rewards and Benefits",
      "answer": "Movie & Dining BOGO on Movie Ticket Bookings Upto 400 With BookMyShow..."
    }
  ],
  "id": "8340",
  "image": "https://cd9941cc.delivery.rocketcdn.me/wp-content/uploads/2024/08/IDFC-First-Bank-Ashva-Metal-Credit-Card.webp",
  "image_id": "4030739641076285",
  "slug": "idfc-first-bank-ashva-metal-credit-card"
}

4. List All Issuers/Banks

GET

Returns a list of all card issuers (banks)

GET https://api.finckr.com/issuer
Example Response 
[
  {
    "id": "8280",
    "name": "Idfc First Bank",
    "slug": "idfc-first-bank"
  },
  {
    "id": "6808",
    "name": "Axis Bank",
    "slug": "axis-bank"
  }
]

5. Get Single Issuer/Bank Details

GET

Returns detailed information about a specific issuer/bank including all their cards

GET https://api.finckr.com/issuer/{bank_slug}

Parameters:

bank_slug (string, required): The slug of the bank (from the issuer list)

Example Request 
GET https://api.finckr.com/issuer/idfc-first-bank
Example Response 
{
  "id": "8280",
  "bank": "Idfc First Bank",
  "cards": [
    {
      "name": "IDFC First Bank Mayura Credit Card",
      "apply_link": "https://finckr.com/go/idfc-mayura",
      "rating": "(4.5/5)",
      "fees": {
        "Joining Fee": "5,999 + GST",
        "Renewal Fee": "5,999 + GST"
      },
      "id": "3294",
      "image": "https://cd9941cc.delivery.rocketcdn.me/wp-content/uploads/2024/08/IDFC-Bank-Mayura-Credit-Card.webp",
      "image_id": "6375535131453461",
      "slug": "idfc-first-bank-mayura-credit-card"
    }
  ]
}

6. Get Card Image

GET

Returns the image for a specific card

GET https://api.finckr.com/images/{image_id}.jpg

Parameters:

image_id (string, required): The image ID from the card details

Example Request 
GET https://api.finckr.com/images/4030739641076285.jpg

Response: JPEG image file

Response Codes

200 OK

Successful request

404 Not Found

Resource not found

500 Internal Server Error

Server error

Rate Limiting

100 requests per minute per IP address

Authentication

No authentication required for public endpoints