---
title: "List cards in Protection Bulletin"
method: GET
path: "/v1/bulletin"
tags: ["Bulletin"]
---

# List cards in Protection Bulletin

`GET /v1/bulletin`

Get all Pismo-issued cards in the Protection Bulletin with filtering options.

 **Note:** This endpoint takes an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

## Query parameters

- `begin_date` string, required
- `end_date` string, required
- `perPage` integer
- `page` integer
- `programId` integer
- `network_brand_type` 'ELO' | 'MASTERCARD' | 'VISA'
- `status` 'PENDING' | 'SUCCESS' | 'FAILED'
- `state` '' | 'BLOCKED' | 'UNBLOCKED'

## Headers

- `Authorization` string, required

## Response `200`

OK

- BulletinResponseListModel — Response model for the Bulletin API list.
  - `current_page` integer — Current page number
  - `pages` integer — Number of pages
  - `per_page` integer — Maximum number of items per page
  - `total_items` integer — Total number of items
  - `items` object[] — List of Bulletin Cards
    - `card_id` integer — Enrolled card ID
    - `org_id` string — Organization ID
    - `program_id` number — Pismo program ID.
    - `network_brand_type` 'ELO' | 'MASTERCARD' | 'VISA' — Card network brand.
    - `created_at` string, date-time — Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM.
    - `updated_at` string, date-time — Datetime program calendar strategy was updated. Format = YYYY-MM-DDTHH:MM:SS:MM
    - `network_track_number` string — Created in the internal system to track the card's event history. This is a combination between the tenant and the truncated random uuid.
    - `state` '' | 'BLOCKED' | 'UNBLOCKED' — Is card blocked or not in the network brand? When the state is empty, it means the network brand did not successfully receive any action.
    - `status` 'PENDING' | 'PROCESSING' | 'CANCELLED' | 'SETTLED' | 'PROCESSED' — PENDING: Charge is scheduled and waiting for the cycle to close. PROCESSING: Cycle closing process has started and is awaiting completion. CANCELLED: Charge canceled due to link cancellation. SETTLED: Amount is zero and/or `minimum_spend_to_charge` has not been reached. PROCESSED: Charge was posted on the statement."
    - `purge_date` string, yyyy-mm-dd — Date when the card will be removed from the Protection Bulletin in the network brand. Format = yyyy-mm-dd.
    - `was_automatically_purged` boolean — Was card removed from the network brand on the purge date?
    - `card_track_number` number — Pismo card track number.
    - `region_code` string[] — Region code contains one or more Account Screen Authorization File (ASAF) region codes that define the distribution of a Visa cardholder account number in Card Recovery Bulletin Service files. **REQUIRED** for Visa. `0` - No Bulletin / V.I.P. Only (cannot be combined with other region codes) `A` - All Asia-Pacific region countries `B` - All Central Europe, Middle East, and Africa (CEMEA) region countries. `C` - All Visa Canada `D` - National Card Recovery Bulletin `E` - All European countries `F` - All Latin America and Caribbean (LAC) region countries Region codes can be in any order, except no other region code can be specified in combination with region code 0. Visa documentation: VisaNet Authorization-Only Online Messages – Technical Specifications - Table 215: Field 127E.2 Account Screen Authorization File (ASAF) Region Codes

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/versions/935b62e16de4/schema)