List all Credit Cards

curl --request GET \
  --url https://demo.spreecommerce.org/api/v2/storefront/account/credit_cards \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "1",
      "type": "credit_card",
      "attributes": {
        "cc_type": "visa",
        "last_digits": "1111",
        "month": 12,
        "year": 2026,
        "name": "John Doe",
        "gateway_payment_profile_id": "card_1JqvNB2eZvKYlo2C5OlqLV7S",
        "default": true
      },
      "relationships": {
        "payment_method": {
          "data": {
            "id": "string",
            "type": "string"
          }
        }
      }
    },
    {
      "id": "2",
      "type": "credit_card",
      "attributes": {
        "cc_type": "mastercard",
        "last_digits": "6695",
        "month": 12,
        "year": 2030,
        "name": "John Doe",
        "default": false
      },
      "relationships": {
        "payment_method": {
          "data": {
            "id": "string",
            "type": "string"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "1",
      "type": "payment_method",
      "attributes": {
        "type": "Spree::Gateway::StripeGateway",
        "name": "Stripe",
        "description": "Stripe Payments",
        "preferences": {}
      }
    }
  ],
  "meta": {
    "count": 2,
    "total_count": 2,
    "total_pages": 1
  },
  "links": {
    "self": "http://localhost:3000/api/v2/storefront/account/credit_cards",
    "next": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=0",
    "prev": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=1",
    "last": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=0",
    "first": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=1"
  }
}

GET

api

storefront

account

credit_cards

List all Credit Cards

curl --request GET \
  --url https://demo.spreecommerce.org/api/v2/storefront/account/credit_cards \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "1",
      "type": "credit_card",
      "attributes": {
        "cc_type": "visa",
        "last_digits": "1111",
        "month": 12,
        "year": 2026,
        "name": "John Doe",
        "gateway_payment_profile_id": "card_1JqvNB2eZvKYlo2C5OlqLV7S",
        "default": true
      },
      "relationships": {
        "payment_method": {
          "data": {
            "id": "string",
            "type": "string"
          }
        }
      }
    },
    {
      "id": "2",
      "type": "credit_card",
      "attributes": {
        "cc_type": "mastercard",
        "last_digits": "6695",
        "month": 12,
        "year": 2030,
        "name": "John Doe",
        "default": false
      },
      "relationships": {
        "payment_method": {
          "data": {
            "id": "string",
            "type": "string"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "1",
      "type": "payment_method",
      "attributes": {
        "type": "Spree::Gateway::StripeGateway",
        "name": "Stripe",
        "description": "Stripe Payments",
        "preferences": {}
      }
    }
  ],
  "meta": {
    "count": 2,
    "total_count": 2,
    "total_pages": 1
  },
  "links": {
    "self": "http://localhost:3000/api/v2/storefront/account/credit_cards",
    "next": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=0",
    "prev": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=1",
    "last": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=0",
    "first": "http://localhost:3000/api/v2/storefront/account/credit_cards?page=1"
  }
}

Authorizations

Authorization

string

header

required

User token to authorize Cart and Checkout requests.

It is required to associate Cart with the User.

Query Parameters

filter[payment_method_id]

string

Filter based on payment method ID

include

string

Specify the related resources you would like to receive in the response body. More Information.

fields[credit_card]

string

Specify the fields you would like returned in the response body. More information.

Response

200 Success - Returns an array of credit_card objects.

data

Credit Card · object[]

required

Show child attributes

data.id

string

required

Example:

"1"

data.type

string

default:credit_card

required

Example:

"credit_card"

data.attributes

object

required

Show child attributes

data.attributes.cc_type

enum<string>

Available options:

visa,

mastercard,

amex

Example:

"visa"

data.attributes.last_digits

string

Last 4 digits of CC number

Example:

"1111"

data.attributes.month

number

Expiration date month

Example:

12

data.attributes.year

number

Expiration date year

Example:

2026

data.attributes.name

string

Card holder name

Example:

"John Doe"

data.attributes.gateway_payment_profile_id

string

ID of a gateway's payment method

Example:

"card_1JqvNB2eZvKYlo2C5OlqLV7S"

data.attributes.default

boolean

Defines if this is the default CC for a signed in user

Example:

true

data.relationships

object

required

Show child attributes

data.relationships.payment_method

object

Show child attributes

data.relationships.payment_method.data

object

Show child attributes

data.relationships.payment_method.data.id

string

required

data.relationships.payment_method.data.type

string

required

API basics

Tutorials

Storefront API

Platform API

List all Credit Cards

Authorizations

Query Parameters

Response