BIN Continuity API Dictionary - Pagos

The BIN Continuity API is coming soon.

This guide is a repository of information about the fields returned by the Pagos BIN Continuity API. The response includes lifecycle metadata in the continuity object and the last known card attributes in the nested card object.

The card object contains the same fields as the BIN Data API enhanced response. This represents the current state of an active BIN, or the last known state of a BIN before it was deleted from the Pagos BIN Database.

Continuity Object Fields

Field	Type	Required	Description	Example
`bin`	string	Yes	The queried BIN value (6-10 digits)	`"41234567"`
`bin_min`	string	Yes	Minimum PAN value for the BIN range	`"4123456700000000"`
`bin_max`	string	Yes	Maximum PAN value for the BIN range	`"4123456799999999"`
`status`	string	Yes	Current lifecycle status of the BIN; see Status Values	`"active"`
`first_seen_at`	string (ISO 8601)	Yes	Timestamp of the first BIN file in which this BIN range appeared	`"2019-03-15T00:00:00Z"`
`last_seen_at`	string (ISO 8601)	Yes	Timestamp of the most recent BIN file in which this BIN range was present	`"2024-11-01T00:00:00Z"`
`flagged_for_delete_at`	string (ISO 8601)	No	Timestamp when the BIN was marked for deletion; `null` if never flagged	`"2024-10-15T00:00:00Z"`
`deleted_at`	string (ISO 8601)	No	Timestamp when the BIN was removed from the BIN file; `null` if still active	`"2024-11-01T00:00:00Z"`
`days_active`	integer	Yes	Total number of days the BIN range was/has been present in BIN files	`2058`
`file_appearances`	integer	Yes	Count of BIN file versions containing this BIN range	`68`
`card`	object	Yes	Last known card attributes for this BIN range; see Card Object	see below

Card Object

The card object contains the last known attributes for the BIN range. This is the same structure as the BIN Data API enhanced response. For deleted BINs, this represents the state of the BIN at the time it was last present in a network source file.

Example Response

{
  "continuity": {
    "bin": "41234567",
    "bin_min": "4123456700000000",
    "bin_max": "4123456799999999",
    "status": "deleted",
    "first_seen_at": "2019-03-15T00:00:00Z",
    "last_seen_at": "2024-10-01T00:00:00Z",
    "flagged_for_delete_at": "2024-10-15T00:00:00Z",
    "deleted_at": "2024-11-15T00:00:00Z",
    "days_active": 2028,
    "file_appearances": 65,
    "card": {
      "number": {
        "length": 16
      },
      "bin_length": 8,
      "pagos_bin_length": 8,
      "bin_min": "4123456700000000",
      "bin_max": "4123456799999999",
      "pan_or_token": "PAN",
      "virtual_card": false,
      "level2": true,
      "level3": true,
      "alm": true,
      "account_updater": true,
      "domestic_only": false,
      "gambling_blocked": false,
      "issuer_currency": "USD",
      "reloadable": false,
      "card_brand": "VISA",
      "card_segment_type": "CONSUMER",
      "combo_card": null,
      "type": "CREDIT",
      "funding_source": "CREDIT",
      "prepaid": false,
      "product": {
        "product_id": "A",
        "product_name": "Visa Traditional"
      },
      "bank": {
        "name": "CHASE BANK USA, N.A.",
        "phone": "1-800-935-9935",
        "url": "www.chase.com",
        "clean_name": "Chase"
      },
      "country": {
        "alpha2": "US",
        "numeric": "840",
        "name": "United States"
      },
      "authentication": {
        "authentication_required": true,
        "authentication_name": "3DS"
      },
      "cost": {
        "interchange": {
          "regulated": false,
          "regulated_name": null,
          "domestic": {
            "cap_region_shortname": "US",
            "cap_advalorem_amount": "1.65",
            "cap_type_name": "PERCENT_PLUS_FIXED",
            "cap_fixed_amount": "0.10",
            "cap_type_qualifier_currency": "USD",
            "cap_type_qualifier_text": null,
            "cap_type_qualifier_lower": null,
            "cap_type_qualifier_upper": null
          },
          "inter": null,
          "intra": null,
          "notes": null
        }
      },
      "networkfees": {},
      "issuer_supports_tokenization": true,
      "multi_account_access_indicator": null,
      "shared_bin": false,
      "flagged_for_delete_remaining_wks": null
    }
  },
  "correlation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

⌘I