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

# List cards in Protection Bulletin

`GET /v1/bulletin`

## Request

- Base URL: `https://sandbox.pismolabs.io/protection-bulletin`
- URL: `https://sandbox.pismolabs.io/protection-bulletin/v1/bulletin`
- Auth: HTTP bearer

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
- `per_page` integer
- `page` integer
- `program_id` number
- `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.
  - `pages` integer: Total number of pages.
  - `per_page` integer: Items per page.
  - `total_items` integer: Total number of items in page.
  - `items` object[]: List of Bulletin Cards
    - `card_id` number: Pismo card ID.
    - `org_id` string: Pismo organization/tenant ID.
    - `program_id` number: Pismo program ID.
    - `network_brand_type` 'ELO' | 'MASTERCARD' | 'VISA': Card network brand.
    - `created_at` string, yyyy-mm-dd hh:mm:ss: Date and time when the Protection Bulletin registration was created. Format = ISO 8601.
    - `updated_at` string, yyyy-mm-dd hh:mm:ss: Date and time when the Protection Bulletin was updated. Format = ISO 8601.
    - `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' | 'SUCCESS' | 'FAILED': Request processing status.
    - `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. <br /> `0` - No Bulletin / V.I.P. Only (cannot be combined with other region codes)<br /> `A` - All Asia-Pacific region countries<br /> `B` - All Central Europe, Middle East, and Africa (CEMEA) region countries.<br /> `C` - All Visa Canada<br /> `D` - National Card Recovery Bulletin<br /> `E` - All European countries<br /> `F` - All Latin America and Caribbean (LAC) region countries <br /> 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.dev/pismo/apis/card-issuing-protection-bulletin.md) - [All operations](https://skmtc.dev/pismo/apis/card-issuing-protection-bulletin/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/card-issuing-protection-bulletin/revisions/9f838f38c69a?raw)