> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pagos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BIN Continuity API Dictionary

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.

<Note>
  The `card` object contains the same fields as the [BIN Data API](/bin-data-APIs/bin-data-api-dictionary) 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.
</Note>

## 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](/bin-data-APIs/bin-continuity-api-overview#bin-lifecycle-statuses) | `"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](#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](/bin-data-APIs/bin-data-api-dictionary#enhanced-data-fields).

For deleted BINs, this represents the state of the BIN at the time it was last present in a network source file.

## Example Response

```json theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.