---
title: "POST /v2/tokens/search"
method: POST
path: "/v2/tokens/search"
tags: ["Tokens"]
---

# POST /v2/tokens/search

`POST /v2/tokens/search`

## Request body

- SearchTokensRequestV2
  - `query` string, nullable
  - `start` string, nullable
  - `size` integer, nullable

## Response `200`

Success

- TokenCursorPaginatedList
  - `pagination` CursorPagination
    - `page_size` integer, nullable
    - `next` string, nullable
  - `data` Token[], nullable
    - `id` string
    - `type` string
    - `tenant_id` string, uuid
    - `data` unknown
    - `metadata` object, nullable
    - `enrichments` TokenEnrichments
      - `bin_details` BinDetails
        - `card_brand` string, nullable
        - `type` string, nullable
        - `prepaid` boolean, nullable
        - `card_segment_type` string, nullable
        - `bank` BinDetailsBank
          - `name` string, nullable
          - `phone` string, nullable
          - `url` string, nullable
          - `clean_name` string, nullable
        - `product` BinDetailsProduct
          - `code` string, nullable
          - `name` string, nullable
        - `country` BinDetailsCountry
          - `alpha2` string, nullable
          - `name` string, nullable
          - `numeric` string, nullable
        - `reloadable` boolean, nullable
        - `pan_or_token` string, nullable
        - `account_updater` boolean, nullable
        - `alm` boolean, nullable
        - `domestic_only` boolean, nullable
        - `gambling_blocked` boolean, nullable
        - `level2` boolean, nullable
        - `level3` boolean, nullable
        - `issuer_currency` string, nullable
        - `combo_card` string, nullable
        - `bin_length` integer, nullable
        - `authentication` unknown
        - `cost` unknown
      - `card_details` TokenEnrichmentsCardDetails
        - `bin` string, nullable
        - `last4` string, nullable
    - `created_by` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `card` CardDetails
      - `bin` string, nullable
      - `last4` string, nullable
      - `expiration_month` integer, nullable
      - `expiration_year` integer, nullable
      - `brand` string, nullable
      - `funding` string, nullable
      - `authentication` string, nullable
      - `issuer` CardIssuer
        - `country` string, nullable
        - `name` string, nullable
      - `issuer_country` CardIssuerCountry
        - `alpha2` string, nullable
        - `name` string, nullable
        - `numeric` string, nullable
      - `segment` string, nullable
      - `product` CardProduct
        - `code` string, nullable
      - `additional` AdditionalCardDetails[], nullable
        - `brand` string, nullable
        - `funding` string, nullable
        - `authentication` string, nullable
        - `issuer` CardIssuer
          - `country` string, nullable
          - `name` string, nullable
    - `bank` BankDetails
      - `routing_number` string, nullable
      - `account_number_last4` string, nullable
    - `network_token` CardDetails
      - `bin` string, nullable
      - `last4` string, nullable
      - `expiration_month` integer, nullable
      - `expiration_year` integer, nullable
      - `brand` string, nullable
      - `funding` string, nullable
      - `authentication` string, nullable
      - `issuer` CardIssuer
        - `country` string, nullable
        - `name` string, nullable
      - `issuer_country` CardIssuerCountry
        - `alpha2` string, nullable
        - `name` string, nullable
        - `numeric` string, nullable
      - `segment` string, nullable
      - `product` CardProduct
        - `code` string, nullable
      - `additional` AdditionalCardDetails[], nullable
        - `brand` string, nullable
        - `funding` string, nullable
        - `authentication` string, nullable
        - `issuer` CardIssuer
          - `country` string, nullable
          - `name` string, nullable
    - `modified_by` string, uuid, nullable
    - `modified_at` string, date-time, nullable
    - `fingerprint` string, nullable
    - `fingerprint_expression` string, nullable
    - `mask` unknown
    - `privacy` Privacy
      - `classification` string, nullable
      - `impact_level` string, nullable
      - `restriction_policy` string, nullable
    - `search_indexes` string[], nullable
    - `expires_at` string, date-time, nullable
    - `containers` string[], nullable
    - `aliases` string[], nullable
    - `authentication` unknown
    - `_extras` TokenExtras
      - `deduplicated` boolean, nullable
      - `tsp_details` TokenServiceProviderDetails
        - `tsp` string, nullable
        - `auth_method` string, nullable
        - `message_id` string, nullable
        - `eci_indicator` string, nullable
        - `assurance_details` AssuranceDetails
          - `account_verified` boolean
          - `card_holder_authenticated` boolean
        - `transaction_id` string, nullable
        - `currency_code` string, nullable
        - `transaction_amount` integer, nullable
        - `cardholder_name` string, nullable
        - `device_manufacturer_identifier` string, nullable
        - `payment_data_type` string, nullable
        - `merchant_token_identifier` string, nullable
        - `authentication_responses` AuthenticationResponse[], nullable
          - `merchant_identifier` string, nullable
          - `authentication_data` string, nullable
          - `transaction_amount` string, nullable
        - `status` string, nullable
      - `deduplication_behavior` string, nullable
      - `network_token_ids` string[], nullable
      - `decrypted_payload` boolean, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/basistheory/apis/basis-theory-api.md) · [All operations](https://skmtc.net/basistheory/apis/basis-theory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basistheory/basis-theory-api/revisions/cbb8e098b560/schema)