NAV Navbar
Logo
Developer PortalBETA
Shell HTTP JavaScript Node.JS Python Ruby Java

Introduction

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

The Capital One API is designed to allow third party access to our data and services via RESTful endpoints. It’s part of our roadmap to be a modern technology-based finance provider and part of the open banking movement. Currently one API is available offering the latest information about our products.

During this early phase of API launch we welcome feedback via email. Whilst in the beta phase we are unable to offer support or guarantee service levels.

Access

https://api-dev.capitalone.co.uk/open-banking/v1/ Production Endpoint; all resources can be accessed via this endpoint.

Consumer Credit Cards

The Consumer Credit Cards resource contains information about Capital One’s latest credit products. Please note that the API schema is inspired by the Open Banking Commercial Credit Card API in an effort of consistency, however is not part of the official definitions. No SLA or warranty is offered on the operation of this API.

Retrieve credit cards

Code samples

# You can also use wget
curl -X get https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json'

GET https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards HTTP/1.1
Host: api-dev.capitalone.co.uk/open-banking/v1
Content-Type: application/json
Accept: application/json

var headers = {
  'Content-Type':'application/json',
  'Accept':'application/json'

};

$.ajax({
  url: 'https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})
require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
}

result = RestClient.get 'https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards', params: {
  }, headers: headers


p JSON.parse(result)
import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

r = requests.get('https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards', params={

}, headers = headers)

print r.json()
URL obj = new URL("https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());
const fetch = require('node-fetch');

const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json'

};

fetch('https://api-dev.capitalone.co.uk/open-banking/v1/consumer-credit-cards',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /consumer-credit-cards

Retrieves a complete list of current credit card products including detailed information for each product.

Responses

     
200
OK
ProductResponse Credit cards are successfully retrieved
400
Bad Request
ErrorResponse The request could not be understood
404
Not Found
ErrorResponse The requested resource was not found
500
Internal Server Error
ErrorResponse Internal system error has occurred
503
Service Unavailable
ErrorResponse The service is temporarily unavailable

Data Models

ProductResponse

{
  "data": [
    {
      "Description": "string",
      "Details": {
        "CCSubType": "FutureMultipleTerms",
        "ConsumerCreditCardItem": {
          "APRRate": "string",
          "AbilityToSetIndividualLimits": false,
          "AccessToOnlineDataReportingTool": false,
          "AnnualFeeAmount": "string",
          "BalanceTransferRate": "string",
          "CardScheme": "Cashcard",
          "CashAdvanceRate": "string",
          "CashWithdrawalsAllowed": false,
          "CashbackPercent": "string",
          "ConvenienceCheque": false,
          "DaysInterestFreeCreditIfPaymentFull": 0,
          "ExchangeRateAdjustment": "string",
          "IssuingEmergencyCardsFees": "string",
          "MaximumNumberOfCardsPermitted": 0,
          "MinimumCreditLimit": "string",
          "MinimumRepaymentAmount": "string",
          "MinimumRepaymentPercentage": "string",
          "NonSterlingTransactionFee": "string",
          "OverLimitFee": "string",
          "PaymentDaysAfterStatement": 0,
          "PurchaseRate": "string",
          "RepaymentFrequency": "AcademicTerm",
          "StatementAtAccountLevel": false,
          "StatementAtPersonalLevel": false
        }
      },
      "Eligibility": {
        "AgeRestricted": false,
        "Description": "string",
        "IncomeRelated": false,
        "MinimumAge": 0,
        "OtherFinancialHoldingRequired": false,
        "PreviousBankruptcy": false,
        "ResidencyRestricted": false
      },
      "KeyFeatures": "string",
      "Organisation": {
        "Brand": {
          "TrademarkID": "string",
          "TrademarkIPOCode": "UK"
        },
        "ParentOrganisation": {
          "OrganisationName": {
            "LegalName": "string"
          }
        }
      },
      "OtherKeyFeatures": "string",
      "PaymentHoliday": false,
      "ProductIdentifier": "string",
      "ProductName": "string",
      "ProductSegment": [
        "Cashback"
      ],
      "ProductType": "ConsumerCreditCard",
      "ProductURL": [
        "string"
      ],
      "TsandCs": [
        "string"
      ]
    }
  ],
  "meta": {
    "Agreement": "string",
    "LastUpdated": "string",
    "License": "string",
    "TermsOfUse": "string",
    "TotalResults": 0
  }
}

API response model that wraps the metadata and products data returned to the client

     
data
REQUIRED
array[Product] Response product data.
meta
REQUIRED
Meta Response metadata.

Product

     
Description
REQUIRED
string High level product description.
Details
REQUIRED
ProductDetails Consumer credit card group.
Eligibility
REQUIRED
Eligibility Eligibility criteria.
KeyFeatures
REQUIRED
string Key features of the product as described on the Capital One website.
Organisation
REQUIRED
Organisation Organisation.
OtherKeyFeatures string Additional features of the card.
PaymentHoliday
REQUIRED
boolean Indicates whether accounts are automatically eligible for payment holidays.
ProductIdentifier
REQUIRED
string Identifier within the parent organisation for the product.
ProductName
REQUIRED
string Name of the Consumer Credit Card.
ProductSegment array[string] Marketing or industry segments that the product is designed for.
ProductType
REQUIRED
string Descriptive code for the product category.
Allowed values: [ConsumerCreditCard]
ProductURL
REQUIRED
array[string] URL provided by the organisation which redirects to the product (on live products only). There might be more than one product at a given URL.
TsandCs
REQUIRED
array[string] URL provided by the parent organisation which redirects to the current T&Cs. Only applies on live products.

ProductDetails

     
CCSubType
REQUIRED
string Credit card subtype.
Allowed values: [FutureMultipleTerms, Promotional, Regular]
ConsumerCreditCardItem
REQUIRED
ConsumerCreditCardItem Consumer credit card item.

ConsumerCreditCardItem

     
APRRate
REQUIRED
string Annual Percentage Rate. The cost of borrowing on your card expressed as a percentage.
AbilityToSetIndividualLimits boolean The ability to set separate limits on different cards in one account.
AccessToOnlineDataReportingTool
REQUIRED
boolean Describes whether the account have access to an online tool for reporting on expenditure.
AnnualFeeAmount
REQUIRED
string Account maintenance fee, charged annually.
BalanceTransferRate string Simple annual interest rate charged on balance transfers.
CardScheme
REQUIRED
string Card scheme code.
Allowed values: [Cashcard, CreditMastercard, CreditVisa]
CashAdvanceRate
REQUIRED
string Simple annual interest rate charged on cash withdrawals.
CashWithdrawalsAllowed
REQUIRED
boolean Describes whether cash withdrawals are allowed.
CashbackPercent string Percent of cashback on amount spent.
ConvenienceCheque
REQUIRED
boolean Describes whether the card account allow convenience cheques.
DaysInterestFreeCreditIfPaymentFull
REQUIRED
integer Describes how many interest free days are given if the card is fully paid at each term. Also known as “Grace days”.
ExchangeRateAdjustment
REQUIRED
string The margin added, by certain card issuers, to the scheme rate in order to arrive at the exchange rate quoted as the reference exchange rate to the cardholder.
IssuingEmergencyCardsFees
REQUIRED
string Amount payable for issuing an emergency card.
MaximumNumberOfCardsPermitted integer The maximum numbers of cardholders per account.
MinimumCreditLimit
REQUIRED
string The minimum credit limit given to successful applications.
MinimumRepaymentAmount string Minimum repayment amount.
MinimumRepaymentPercentage string Percentage of total account balance that will be assessed as a minimum payment in addition to interest and fees.
NonSterlingTransactionFee string A fee applied to all non-Sterling card transactions.
OverLimitFee string Fee applicable if the card balance exceeds the credit limit.
PaymentDaysAfterStatement
REQUIRED
integer How many days after statement is the payment expected.
PurchaseRate
REQUIRED
string Simple annuals interest rate charged on purchases.
RepaymentFrequency
REQUIRED
string Repayment frequency.
Allowed values: [AcademicTerm, HalfYearly, Monthly, Quarterly, Weekly, Yearly]
StatementAtAccountLevel
REQUIRED
boolean Describes whether there is a statement at account level.
StatementAtPersonalLevel
REQUIRED
boolean Describes whether there is a statement at card level.

Eligibility

     
AgeRestricted
REQUIRED
boolean Indicates a customer’s age is part of eligibility criteria.
Description
REQUIRED
string Eligibility details as described on the Capital One website.
IncomeRelated boolean Indicates if eligibility linked to income.
MinimumAge integer Minimum age, in years, required to hold an account.
OtherFinancialHoldingRequired
REQUIRED
boolean Indicates that it is necessary to hold another product with the bank in order to be eligible for this product or feature.
PreviousBankruptcy
REQUIRED
boolean Describes if a previous bankruptcy / insolvency disqualifies for this card.
ResidencyRestricted
REQUIRED
boolean Indicates a customer’s residency forms part of the eligibility criteria.

Organisation

     
Brand
REQUIRED
Brand Brand.
ParentOrganisation
REQUIRED
ParentOrganisation Parent organisation.

Brand

     
TrademarkID
REQUIRED
string The trademark number that has been registered with the Intellectual Property Office.
TrademarkIPOCode
REQUIRED
string The Intellectual Property Office (IPO) is the official body responsible for intellectual property (IP) rights including patents, designs, trademarks and copyright.
Allowed values: [UK, EU]

ParentOrganisation

     
OrganisationName
REQUIRED
OrganisationName Organisation name.

OrganisationName

     
LegalName
REQUIRED
string Legal Name of the organisation.

Meta

     
Agreement
REQUIRED
string Open Banking License agreement.
LastUpdated
REQUIRED
string Time at which the product information was last updated.
License
REQUIRED
string Open Banking License.
TermsOfUse
REQUIRED
string Open Banking Terms of Use.
TotalResults
REQUIRED
integer Total number of products returned in the response.

ErrorResponse

{
  "description": "string",
  "status": "string",
  "title": "string"
}
     
description
REQUIRED
string Description of the error being reported.
status
REQUIRED
string Status code of the error.
title
REQUIRED
string Summary of the error being reported.