# Lithic Developer API API

> Lithic Developer API API on Apizie: 226 endpoints (Get a list of individual or business account holders, Create an individual or business account holder, Get an individual or business account holder, Update account holder information and possibly resubmit for evaluation, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/payments:lithic/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `payments:lithic`
- Category: Payments
- Status: byok
- Source: https://support.lithic.com/
- Page: https://zieapi.vercel.app/api/payments/lithic
- OpenAPI: https://zieapi.vercel.app/api/payments/lithic/openapi.json

The Lithic Developer API is designed to provide a predictable programmatic interface for accessing your Lithic account through an API and transaction webhooks. Note that your API key is a secret and should be treated…

## Endpoints

### Get a list of individual or business account holders
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-holders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_id | string | no | If applicable, represents the external_id associated with the account_holder. |
| limit | integer | no | The number of account_holders to limit the response to. |
| first_name | string | no | (Individual Account Holders only) The first name of the account holder. The query is case insensitive and supports partial matches. |
| last_name | string | no | (Individual Account Holders only) The last name of the account holder. The query is case insensitive and supports partial matches. |
| legal_business_name | string | no | (Business Account Holders only) The legal business name of the account holder. The query is case insensitive and supports partial matches. |
| phone_number | string | no | Phone number of the account holder. The query must be an exact match. |
| email | string | no | Email address of the account holder. The query must be an exact match, case insensitive. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |

### Create an individual or business account holder
`POST https://zieapi.vercel.app/v1/payments:lithic/post-account-holders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get an individual or business account holder
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-holder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |

### Update account holder information and possibly resubmit for evaluation
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-account-holder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |
| body | object | yes | JSON request body |

### Get account holder document uploads
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-holder-documents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |

### Initiate account holder document upload
`POST https://zieapi.vercel.app/v1/payments:lithic/post-account-holder-documents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |
| body | object | yes | JSON request body |

### Get account holder document upload status
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-holder-document-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |
| document_token | string | yes | Globally unique identifier for the document. |

### Create a new beneficial owner individual or replace the existing control person entity
`POST https://zieapi.vercel.app/v1/payments:lithic/post-account-holder-entities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |
| body | object | yes | JSON request body |

### Deactivate a beneficial owner individual
`POST https://zieapi.vercel.app/v1/payments:lithic/delete-account-holder-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_holder_token | string | yes | Globally unique identifier for the account holder. |
| entity_token | string | yes | Globally unique identifier for the entity. |

### List accounts
`GET https://zieapi.vercel.app/v1/payments:lithic/get-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Get account
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | yes | Globally unique identifier for account. |

### Update account
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-account-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | yes | Globally unique identifier for account. |
| body | object | yes | JSON request body |

### Get account's available spend limits
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-spend-limits` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | yes | Globally unique identifier for account. |

### List rules
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |
| card_token | string | no | Only return Auth Rules that are bound to the provided card token. |
| account_token | string | no | Only return Auth Rules that are bound to the provided account token. |
| business_account_token | string | no | Only return Auth Rules that are bound to the provided business account token. |
| scope | string | no | Only return Auth Rules that are bound to the provided scope. When no token is provided, `CARD` also returns Auth Rules that include a… |
| event_stream | string | no | Deprecated: Use event_streams instead. Only return Auth rules that are executed during the provided event stream. |
| event_streams | array | no | Only return Auth rules that are executed during any of the provided event streams. If event_streams and event_stream are specified, the… |

### Create a new rule
`POST https://zieapi.vercel.app/v1/payments:lithic/post-auth-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Fetch a rule
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |

### Update a rule
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-auth-rule-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| body | object | yes | JSON request body |

### Delete a rule
`POST https://zieapi.vercel.app/v1/payments:lithic/delete-auth-rule-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |

### Update rule entities
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-auth-rule-entities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| body | object | yes | JSON request body |

### Draft a new rule version
`POST https://zieapi.vercel.app/v1/payments:lithic/post-auth-rule-draft` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| body | object | yes | JSON request body |

### Calculated Feature values
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-features` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| account_token | string | no |  |
| card_token | string | no |  |

### Promote a rule version
`POST https://zieapi.vercel.app/v1/payments:lithic/post-auth-rule-promote` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |

### List rule versions
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |

### Retrieve a performance report
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| begin | string | yes | Start date for the report |
| end | string | yes | End date for the report |

### List backtests
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-backtests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Request a backtest
`POST https://zieapi.vercel.app/v1/payments:lithic/post-auth-rule-backtest` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| body | object | yes | JSON request body |

### Retrieve backtest results
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-backtest-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_rule_token | string | yes |  |
| auth_rule_backtest_token | string | yes |  |

### List rule evaluation results
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-rule-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |
| event_token | string | no | Filter by event token |
| auth_rule_token | string | no | Filter by Auth Rule token |
| begin | string | no | Date string in RFC 3339 format. Only events evaluated after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only events evaluated before the specified time will be included. UTC time zone. |
| has_actions | boolean | no | Filter by whether the rule evaluation produced any actions. When not provided, all results are returned. |

### Fetch card signals
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-signals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes | The token of the card to fetch signals for. |

### Fetch account signals
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-signals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | yes | The token of the account to fetch signals for. |

### Retrieve the ASA HMAC secret key
`GET https://zieapi.vercel.app/v1/payments:lithic/get-auth-stream-secret` (byok)

### Rotate the ASA HMAC secret key
`POST https://zieapi.vercel.app/v1/payments:lithic/rotate-auth-stream-secret` (byok)

### List balances
`GET https://zieapi.vercel.app/v1/payments:lithic/get-balances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | no | List balances for all financial accounts of a given account_token. |
| business_account_token | string | no | List balances for all financial accounts of a given business_account_token. |
| balance_date | string | no | UTC date and time of the balances to retrieve. Defaults to latest available balances |
| financial_account_type | string | no | List balances for a given Financial Account type. |

### List card programs
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-programs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Get card program
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-program` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_program_token | string | yes | Globally unique identifier for the card program. |

### List cards
`GET https://zieapi.vercel.app/v1/payments:lithic/get-cards` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | no | Returns cards associated with the specified account. |
| state | string | no | Returns cards with the specified state. |
| memo | string | no | Returns cards containing the specified partial or full memo text. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Create card
`POST https://zieapi.vercel.app/v1/payments:lithic/post-cards` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Idempotency-Key | string | no | Idempotency key for the request |
| body | object | yes | JSON request body |

### Search for card by PAN
`POST https://zieapi.vercel.app/v1/payments:lithic/search-card-by-pan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get card
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |

### Update card
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-card-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| body | object | yes | JSON request body |

### Get card balances
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-balance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| balance_date | string | no | UTC date of the balance to retrieve. Defaults to latest available balance |
| last_transaction_event_token | string | no | Balance after a given financial event occured. For example, passing the event_token of a $5 CARD_CLEARING financial event will return a… |
| card_token | string | yes |  |

### List card financial transactions
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-financial-transactions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | no | Financial Transaction category to be returned. |
| result | string | no | Financial Transaction result to be returned. |
| status | string | no | Financial Transaction status to be returned. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| card_token | string | yes |  |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Get card financial transaction
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-financial-transaction-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| financial_transaction_token | string | yes | Globally unique identifier for financial transaction token. |

### Provision card (Digital Wallet)
`POST https://zieapi.vercel.app/v1/payments:lithic/post-card-provision` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes | The unique token of the card to add to the device's digital wallet. |
| body | object | yes | JSON request body |

### Web Push Provision card (Digital Wallet)
`POST https://zieapi.vercel.app/v1/payments:lithic/post-card-web-provision` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes | The unique token of the card to add to the device's digital wallet. |
| body | object | yes | JSON request body |

### Reissue physical card
`POST https://zieapi.vercel.app/v1/payments:lithic/post-card-reissue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| body | object | yes | JSON request body |

### Renew a card
`POST https://zieapi.vercel.app/v1/payments:lithic/post-card-renew` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| body | object | yes | JSON request body |

### Reassign a card to another account
`POST https://zieapi.vercel.app/v1/payments:lithic/post-card-reassign-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| body | object | yes | JSON request body |

### Convert virtual to physical card
`POST https://zieapi.vercel.app/v1/payments:lithic/post-convert-physical` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| body | object | yes | JSON request body |

### Get card's available spend limit
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-spend-limits` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |

### Create card embed session
`POST https://zieapi.vercel.app/v1/payments:lithic/create-card-embed-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| card_token | string | yes |  |
| body | object | yes | JSON request body |

### Respond to Authorization Challenge
`POST https://zieapi.vercel.app/v1/payments:lithic/respond-to-authorization-challenge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_token | string | yes | Globally unique identifier for the authorization event that triggered the challenge |
| body | object | no | JSON request body |

### List bulk orders
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-bulk-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Create bulk order
`POST https://zieapi.vercel.app/v1/payments:lithic/post-card-bulk-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get bulk order
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-bulk-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bulk_order_token | string | yes | Globally unique identifier for the bulk order |

### Update bulk order
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-card-bulk-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bulk_order_token | string | yes | Globally unique identifier for the bulk order |
| body | object | yes | JSON request body |

### List digital card art
`GET https://zieapi.vercel.app/v1/payments:lithic/get-digital-card-art` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Get digital card art by token
`GET https://zieapi.vercel.app/v1/payments:lithic/get-digital-card-art-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| digital_card_art_token | string | yes | Specifies the digital card art to be displayed in the user’s digital wallet after tokenization. This artwork must be approved by… |

### List chargeback requests
`GET https://zieapi.vercel.app/v1/payments:lithic/get-disputes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | no | Filter by status. |
| transaction_tokens | array | no | Transaction tokens to filter by. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Request chargeback
`POST https://zieapi.vercel.app/v1/payments:lithic/post-disputes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get chargeback request
`GET https://zieapi.vercel.app/v1/payments:lithic/get-dispute-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dispute_token | string | yes |  |

### Update chargeback request
`POST https://zieapi.vercel.app/v1/payments:lithic/update-dispute-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dispute_token | string | yes |  |
| body | object | yes | JSON request body |

### Withdraw chargeback request
`POST https://zieapi.vercel.app/v1/payments:lithic/delete-dispute-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dispute_token | string | yes |  |

### List evidence
`GET https://zieapi.vercel.app/v1/payments:lithic/get-dispute-evidences` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| dispute_token | string | yes |  |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Upload evidence
`POST https://zieapi.vercel.app/v1/payments:lithic/post-evidence-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dispute_token | string | yes |  |
| body | object | no | JSON request body |

### Get evidence
`GET https://zieapi.vercel.app/v1/payments:lithic/get-dispute-evidence-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| evidence_token | string | yes |  |
| dispute_token | string | yes |  |

### Delete evidence
`POST https://zieapi.vercel.app/v1/payments:lithic/delete-dispute-evidence-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| evidence_token | string | yes |  |
| dispute_token | string | yes |  |

### Get card embed iframe
`GET https://zieapi.vercel.app/v1/payments:lithic/get-card-embed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| session | string | yes | The short-lived credential returned by the session creation endpoint. Treat it as sensitive and use it only in the iframe `src`. |
| type | string | yes | The type of embed to return. `CARD_EMBED` sessions support `PAN`, `CVV`, `EXP_MONTH`, and `EXP_YEAR`. `PIN_SETTING_EMBED` sessions support… |
| styles | string | no | Optional base64-encoded JSON object containing base CSS declarations and nested pseudo-class declarations to apply to the iframe.… |
| configuration | string | no | Optional standard base64-encoded JSON configuration for the requested iframe. URL-encode the base64 value when adding it to the query… |

### Get a fraud report for a transaction
`GET https://zieapi.vercel.app/v1/payments:lithic/get-fraud-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| transaction_token | string | yes | The token of the transaction that the enhanced data is associated with. |

### Create or update a fraud report for a transaction
`POST https://zieapi.vercel.app/v1/payments:lithic/create-update-fraud-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| transaction_token | string | yes | The token of the transaction that the enhanced data is associated with. |
| body | object | yes | JSON request body |

### List enhanced commercial data
`GET https://zieapi.vercel.app/v1/payments:lithic/list-enhanced-transaction-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| transaction_token | string | yes | The token of the transaction that the enhanced data is associated with. |

### Expire an authorization
`POST https://zieapi.vercel.app/v1/payments:lithic/expire-authorization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| transaction_token | string | yes | The token of the transaction to expire. |

### Route a transaction
`POST https://zieapi.vercel.app/v1/payments:lithic/route-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| transaction_token | string | yes | The token of the transaction to route. |
| body | object | yes | JSON request body |

### Get enhanced commercial data
`GET https://zieapi.vercel.app/v1/payments:lithic/get-enhanced-transaction-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_token | string | yes | The token of the transaction event that the enhanced data is associated with. |

### List event subscriptions
`GET https://zieapi.vercel.app/v1/payments:lithic/get-event-subscriptions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Create event subscription
`POST https://zieapi.vercel.app/v1/payments:lithic/create-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get event subscription
`GET https://zieapi.vercel.app/v1/payments:lithic/get-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |

### Update event subscription
`POST https://zieapi.vercel.app/v1/payments:lithic/update-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |
| body | object | no | JSON request body |

### Delete event subscription
`POST https://zieapi.vercel.app/v1/payments:lithic/delete-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |
| body | object | no | JSON request body |

### List message attempts for an event subscription
`GET https://zieapi.vercel.app/v1/payments:lithic/get-message-attempts-for-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | no |  |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| event_subscription_token | string | yes |  |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Resend failed messages
`POST https://zieapi.vercel.app/v1/payments:lithic/recover-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| body | object | no | JSON request body |

### Replay missing messages
`POST https://zieapi.vercel.app/v1/payments:lithic/replay-missing-event-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |

### Get event subscription secret
`GET https://zieapi.vercel.app/v1/payments:lithic/get-event-subscription-secret` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |

### Rotate event subscription secret
`POST https://zieapi.vercel.app/v1/payments:lithic/rotate-event-subscription-secret` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |

### List events
`GET https://zieapi.vercel.app/v1/payments:lithic/get-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_types | array | no | Event types to filter events by. |
| with_content | boolean | no | Whether to include the event payload content in the response. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Get event
`GET https://zieapi.vercel.app/v1/payments:lithic/get-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_token | string | yes |  |

### List message attempts for an event
`GET https://zieapi.vercel.app/v1/payments:lithic/get-message-attempts-for-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | no |  |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| event_token | string | yes |  |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Resend event
`POST https://zieapi.vercel.app/v1/payments:lithic/resend-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_subscription_token | string | yes |  |
| event_token | string | yes |  |
| body | object | no | JSON request body |

### Create blockchain recipient
`POST https://zieapi.vercel.app/v1/payments:lithic/create-blockchain-recipient` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get blockchain recipient
`GET https://zieapi.vercel.app/v1/payments:lithic/get-blockchain-recipient` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| blockchain_recipient_token | string | yes |  |

### List external bank accounts
`GET https://zieapi.vercel.app/v1/payments:lithic/search-external-bank-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | no |  |
| account_types | array | no |  |
| countries | array | no |  |
| owner_types | array | no |  |
| states | array | no |  |
| verification_states | array | no |  |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Create external bank account
`POST https://zieapi.vercel.app/v1/payments:lithic/create-external-bank-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get external bank account by token
`GET https://zieapi.vercel.app/v1/payments:lithic/get-external-bank-account-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |

### Update external bank account
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-external-bank-account-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |
| body | object | yes | JSON request body |

### Verify external bank account via micro deposit amounts
`POST https://zieapi.vercel.app/v1/payments:lithic/verify-external-bank-account-by-micro-deposits` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |
| body | object | yes | JSON request body |

### Pause external bank account
`POST https://zieapi.vercel.app/v1/payments:lithic/pause-external-bank-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |

### Retry external bank account via micro deposit
`POST https://zieapi.vercel.app/v1/payments:lithic/retry-micro-deposit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |
| body | object | no | JSON request body |

### Retry external bank account via prenote
`POST https://zieapi.vercel.app/v1/payments:lithic/retry-prenote` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |
| body | object | no | JSON request body |

### Set verification method
`POST https://zieapi.vercel.app/v1/payments:lithic/set-verification-method` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |
| body | object | yes | JSON request body |

### Unpause external bank account
`POST https://zieapi.vercel.app/v1/payments:lithic/unpause-external-bank-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| external_bank_account_token | string | yes |  |

### Get extended credit
`GET https://zieapi.vercel.app/v1/payments:lithic/get-extended-credit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| credit_product_token | string | yes | Credit Product Token |

### Get Credit Product Prime Rates
`GET https://zieapi.vercel.app/v1/payments:lithic/get-prime-rates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| credit_product_token | string | yes | Globally unique identifier for credit products. |
| starting_after | string | no | The effective date that the prime rate starts after |
| ending_before | string | no | The effective date that the prime rates ends before |

### Post Credit Product Prime Rate
`POST https://zieapi.vercel.app/v1/payments:lithic/create-prime-rates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| credit_product_token | string | yes | Globally unique identifier for credit products. |
| body | object | yes | JSON request body |

### List financial accounts
`GET https://zieapi.vercel.app/v1/payments:lithic/get-financial-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_token | string | no | List financial accounts for a given account_token or business_account_token |
| business_account_token | string | no | List financial accounts for a given business_account_token |
| type | string | no | List financial accounts of a given type |

### Create financial account
`POST https://zieapi.vercel.app/v1/payments:lithic/create-financial-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Idempotency-Key | string | no | Idempotency key for the request |
| body | object | no | JSON request body |

### Get financial account
`GET https://zieapi.vercel.app/v1/payments:lithic/get-financial-account-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes |  |

### Update financial account
`POST https://zieapi.vercel.app/v1/payments:lithic/update-financial-account-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes |  |
| body | object | no | JSON request body |

### Get balances
`GET https://zieapi.vercel.app/v1/payments:lithic/get-balance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| balance_date | string | no | UTC date of the balance to retrieve. Defaults to latest available balance |
| last_transaction_event_token | string | no | Balance after a given financial event occured. Note: if an account receives multiple events around the same time whose financial impacts… |
| financial_account_token | string | yes | Globally unique identifier for financial account. |

### Get open to buy
`GET https://zieapi.vercel.app/v1/payments:lithic/get-open-to-buy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for the Security Account to price |

### Get account credit configuration
`GET https://zieapi.vercel.app/v1/payments:lithic/get-account-credit-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for financial account. |

### Update account credit configuration
`POST https://zieapi.vercel.app/v1/payments:lithic/patch-account-credit-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for financial account. |
| body | object | no | JSON request body |

### List financial transactions
`GET https://zieapi.vercel.app/v1/payments:lithic/get-financial-transactions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | no | Financial Transaction category to be returned. |
| result | string | no | Financial Transaction result to be returned. |
| status | string | no | Financial Transaction status to be returned. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| financial_account_token | string | yes | Globally unique identifier for financial account. |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Get financial transaction
`GET https://zieapi.vercel.app/v1/payments:lithic/get-financial-transaction-by-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for financial account. |
| financial_transaction_token | string | yes | Globally unique identifier for financial transaction token. |

### Register Account Number
`POST https://zieapi.vercel.app/v1/payments:lithic/register-account-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for financial account. |
| body | object | no | JSON request body |

### List holds
`GET https://zieapi.vercel.app/v1/payments:lithic/get-financial-account-holds` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for the financial account. |
| status | string | no | Hold status to filter by. |
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone. |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |

### Create hold
`POST https://zieapi.vercel.app/v1/payments:lithic/create-hold` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for the financial account. |
| body | object | yes | JSON request body |

### Get hold
`GET https://zieapi.vercel.app/v1/payments:lithic/get-hold` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| hold_token | string | yes | Globally unique identifier for the hold. |

### Void hold
`POST https://zieapi.vercel.app/v1/payments:lithic/void-hold` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| hold_token | string | yes | Globally unique identifier for the hold. |
| body | object | yes | JSON request body |

### List statements
`GET https://zieapi.vercel.app/v1/payments:lithic/get-statements` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| begin | string | no | Date string in RFC 3339 format. Only entries created after the specified date will be included. |
| end | string | no | Date string in RFC 3339 format. Only entries created before the specified date will be included. |
| ending_before | string | no | A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this… |
| financial_account_token | string | yes | Globally unique identifier for financial account. |
| page_size | integer | no | Page size (for pagination). |
| starting_after | string | no | A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item. |
| include_initial_statements | boolean | no | Whether to include the initial statement. It is not included by default. |

### Get statement by token
`GET https://zieapi.vercel.app/v1/payments:lithic/get-statement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| financial_account_token | string | yes | Globally unique identifier for financial account. |
| statement_token | string | yes | Globally unique identifier for statements. |

…and 106 more. See the OpenAPI spec.

## Example
```
curl "https://zieapi.vercel.app/v1/payments:lithic/get-account-holders" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Lithic Developer API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/payments:lithic/get-account-holders with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Lithic Developer API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Lithic Developer API itself also needs your own key from lithic.com.

### Can AI agents use the Lithic Developer API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key payments:lithic.

### What is the status of the Lithic Developer API API?
Needs your own provider key (bring your own key)