Bulletin

List cards in Protection 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.

get/v1/bulletin

Request

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

Query parameters

begin_datestring required

Example:2025-01-01

Beginning date filter, format = yyyy-mm-dd

end_datestring required

Example:2025-01-30

End date filter, format = yyyy-mm-dd

per_pageinteger

Example:20

Number of items per page to return. Default is 10.

pageinteger

Example:2

Page to return. Default is 1.

program_idnumber

Example:1010

Pismo program ID

network_brand_type'ELO' | 'MASTERCARD' | 'VISA'

Example:ELO

Card network brand.

status'PENDING' | 'SUCCESS' | 'FAILED'

Example:PENDING

Request processing status.

state'' | 'BLOCKED' | 'UNBLOCKED'

Example:BLOCKED

Is card blocked or not in the network brand?

When empty, it means the network did not successfully receive the action.

Headers

Authorizationstring required

Example:Bearer eyJhbGci...IUzUx

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.

Response

current_pageinteger

Current page.

pagesinteger

Total number of pages.

per_pageinteger

Items per page.

total_itemsinteger

Total number of items in page.

Example response

{
  "current_page": 1,
  "pages": 1,
  "per_page": 100,
  "total_items": 10,
  "items": [
    {
      "card_id": 10203040,
      "org_id": "TN-123XXX-XXXXXX-XXXXXXX",
      "program_id": 1010,
      "network_brand_type": "ELO",
      "created_at": "2025-04-22 20:31:50",
      "updated_at": "2025-04-22 20:31:50",
      "network_track_number": "TN-123XXX-XXXXXX-XXXXXXX::1a2b3c",
      "state": "BLOCKED",
      "status": "PENDING",
      "purge_date": "2025-04-22",
      "was_automatically_purged": true,
      "card_track_number": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.