---
title: "Get a summary of your card program"
method: GET
path: "/developer/cards/summary"
tags: ["Cards"]
---

# Get a summary of your card program

`GET /developer/cards/summary`

Get a summary of your card program, optionally for a specific period.

## Query parameters

- `period` 'year' | 'month' | 'week' | 'day' | 'lifetime', required
- `period_key` string

## Response `200`

The summary of a card program

- CardProgramSummary — The summary of a card program for a given period
  - `period` 'year' | 'month' | 'week' | 'day' | 'lifetime' — The period type of the card program summary
  - `period_starting` string — The starting date of the period, in ISO8601 format
  - `cards_provisioned_count` integer — The number of cards provisioned during the period
  - `card_transactions_count` integer — The number of card transactions during the period, excluding refunds.
  - `provisioned_cards_by_country` object — The number of cards provisioned during the period, by issuing country. The key is the ISO-3166-1 alpha-3 country code, and the value is the number of cards provisioned for that issuing country.
  - `transaction_volume` string — The total transaction volume during the period, in USD
  - `transacting_card_accounts_count` integer — The number of card accounts that transacted during the period
  - `card_transactions_count_by_country` object — The number of card transactions during the period, by merchant country. The key is the ISO-3166-1 alpha-3 country code, and the value is the number of card transactions for that merchant country.
  - `transaction_volume_by_country` object — The transaction volume during the period, by merchant country. The key is the ISO-3166-1 alpha-3 country code, and the value is the transaction volume for that merchant country.
  - `transacting_cards_by_country` object — The number of cards that transacted during the period, by issuing country. The key is the ISO-3166-1 alpha-3 country code, and the value is the number of cards transacted for that issuing country.

## Other responses

- `400` — Request containing missing or invalid parameters.
- `401` — Missing or invalid API key
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/versions/570998bde3b5/schema)