---
title: "PATCH /tokens/{id}"
method: PATCH
path: "/tokens/{id}"
tags: ["Tokens"]
---

# PATCH /tokens/{id}

`PATCH /tokens/{id}`

## Path parameters

- `id` string, required

## Response `200`

Success

- Token
  - `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
- `404` — Not Found
- `409` — Conflict

---

[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)