Skip to main content
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

FieldTypeRequiredDescriptionExample
binstringYesThe queried BIN value (6-10 digits)"41234567"
bin_minstringYesMinimum PAN value for the BIN range"4123456700000000"
bin_maxstringYesMaximum PAN value for the BIN range"4123456799999999"
statusstringYesCurrent lifecycle status of the BIN; see Status Values"active"
first_seen_atstring (ISO 8601)YesTimestamp of the first BIN file in which this BIN range appeared"2019-03-15T00:00:00Z"
last_seen_atstring (ISO 8601)YesTimestamp of the most recent BIN file in which this BIN range was present"2024-11-01T00:00:00Z"
flagged_for_delete_atstring (ISO 8601)NoTimestamp when the BIN was marked for deletion; null if never flagged"2024-10-15T00:00:00Z"
deleted_atstring (ISO 8601)NoTimestamp when the BIN was removed from the BIN file; null if still active"2024-11-01T00:00:00Z"
days_activeintegerYesTotal number of days the BIN range was/has been present in BIN files2058
file_appearancesintegerYesCount of BIN file versions containing this BIN range68
cardobjectYesLast known card attributes for this BIN range; see Card Objectsee 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"
}