> ## Documentation Index
> Fetch the complete documentation index at: https://docs.churningtracker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List credit cards



## OpenAPI

````yaml /api-reference/openapi.json get /credit-cards
openapi: 3.1.0
info:
  title: Churning Tracker API
  version: 1.0.0
  description: Read and write your buying group orders, gift card orders, and shipments.
servers:
  - url: https://app.churningtracker.com/api/v1
security:
  - apiKey: []
    apiSecret: []
tags:
  - name: Buying group orders
  - name: Gift card orders
  - name: Shipments
  - name: Credit cards
paths:
  /credit-cards:
    get:
      tags:
        - Credit cards
      summary: List credit cards
      operationId: list-credit-cards
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: offset
          in: query
          schema:
            type: integer
            minimum: 0
            default: 0
      responses:
        '200':
          description: A page of credit cards.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - pagination
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CreditCard'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              example:
                data:
                  - id: 5a1e9c2b-7d3f-4b8a-9e6c-0f1d2a3b4c5d
                    name: Sapphire Preferred
                    issuer: Chase
                    nickname: Daily driver
                    lastDigits: '1234'
                    accountOwner: Jordan
                    annualFee: 9500
                    earnRate: 2
                    openedAt: '2025-03-14'
                    closedAt: null
                    subCards:
                      - id: 8b2f0d3c-6e4a-4f1b-a7c9-1d2e3f4a5b6c
                        cardType: authorized_user
                        nickname: P2
                        lastDigits: '9876'
                pagination:
                  limit: 25
                  offset: 0
                  totalCount: 1
        '400':
          description: Invalid query parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Your plan doesn't include API access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreditCard:
      type: object
      required:
        - id
        - name
        - issuer
        - nickname
        - lastDigits
        - accountOwner
        - annualFee
        - earnRate
        - openedAt
        - closedAt
        - subCards
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          description: The card product.
        issuer:
          type: string
        nickname:
          type:
            - string
            - 'null'
        lastDigits:
          type:
            - string
            - 'null'
        accountOwner:
          type: string
          description: Name of the account owner who holds the card.
        annualFee:
          type: integer
          minimum: 0
          description: Annual fee in cents.
        earnRate:
          type: number
          description: >-
            Points or cashback multiplier, e.g. `2` for 2x or `1.5` for 1.5x. Up
            to three decimal places.
        openedAt:
          type:
            - string
            - 'null'
          format: date
        closedAt:
          type:
            - string
            - 'null'
          format: date
          description: Null while the card is open.
        subCards:
          type: array
          description: Authorized user, employee, and virtual cards on this card.
          items:
            $ref: '#/components/schemas/SubCard'
    Pagination:
      type: object
      required:
        - limit
        - offset
        - totalCount
      properties:
        limit:
          type: integer
        offset:
          type: integer
        totalCount:
          type: integer
          description: Items matching the filters across all pages.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: invalid_request
            message:
              type: string
            issues:
              type: array
              description: Per-field problems, when there are any.
              items:
                type: object
                properties:
                  path:
                    type: string
                    example: orderLineItems.0.unitPrice
                  message:
                    type: string
    SubCard:
      type: object
      required:
        - id
        - cardType
        - nickname
        - lastDigits
      properties:
        id:
          type: string
          format: uuid
        cardType:
          type: string
          enum:
            - authorized_user
            - employee_card
            - virtual_card
        nickname:
          type:
            - string
            - 'null'
        lastDigits:
          type:
            - string
            - 'null'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key, starting with `ct_key_`.
    apiSecret:
      type: apiKey
      in: header
      name: x-api-secret
      description: Your API secret, starting with `ct_secret_`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.