---
title: "POST /token-intents"
method: POST
path: "/token-intents"
tags: ["TokenIntents"]
---

# POST /token-intents

`POST /token-intents`

## Request body

- CreateTokenIntentRequest
  - `type` string, required
  - `data` unknown
  - `encrypted` string, nullable

## Response `201`

Created

- CreateTokenIntentResponse
  - `id` string, nullable
  - `type` string, nullable
  - `tenant_id` string, uuid
  - `fingerprint` string, nullable
  - `created_by` string, uuid
  - `created_at` string, date-time
  - `expires_at` string, date-time
  - `data` unknown
  - `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
  - `authentication` unknown
  - `_extras` TokenIntentExtras
    - `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
    - `network_token_ids` string[], nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Client Error

---

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