> ## 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

<Warning>
  The BIN Continuity API is coming soon.
</Warning>

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"
}
```