v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

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

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

perPageinteger

Example:15

Items per page

pageinteger

Example:1

Page number

programIdinteger

Example:12345

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 number

pagesinteger

Number of pages

per_pageinteger

Maximum number of items per page

total_itemsinteger

Total number of items

Example response

{
  "current_page": 1,
  "pages": 10,
  "per_page": 15,
  "total_items": 100,
  "items": [
    {
      "card_id": 6743052,
      "org_id": "TN-cc8f8b89-233a-4582-9f36-63ee85278d6d",
      "program_id": 1010,
      "network_brand_type": "ELO",
      "created_at": "2024-09-12T16:46:16.43663522",
      "updated_at": "2024-09-12T16:46:16.43663522",
      "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
    }
  ]
}