# Finup API

> Client-facing API documentation for Finup accounts, cards, users, and transactions.

- [Finup API](https://docs.finup.io/introduction.md): Use the Finup API to manage accounts, cards, users, and transaction data.
- [Quickstart](https://docs.finup.io/quickstart.md): Make your first Finup API request.
- [Authentication](https://docs.finup.io/guides/authentication.md): Authenticate Finup API requests with API keys.
- [Webhooks](https://docs.finup.io/guides/webhooks.md): Subscribe to Finup webhook events, verify signatures, and handle retries.
- [Pagination](https://docs.finup.io/guides/pagination.md): Use pagination objects for Finup list endpoints.
- [Errors](https://docs.finup.io/guides/errors.md): Understand common Finup API error responses.
- [MCP server](https://docs.finup.io/guides/mcp.md): Connect AI assistants like Claude, Cursor, and ChatGPT to your Finup account.
- [API reference overview](https://docs.finup.io/reference/overview.md): Public endpoint groups included in the Finup API reference.
- [Users](https://docs.finup.io/reference/users.md): Read and update the current Finup user profile.
- [Create account](https://docs.finup.io/api-reference/accounts/create-account.md)
- [Get account capabilities](https://docs.finup.io/api-reference/accounts/get-account-capabilities.md): Returns current account limits, capabilities, status, and fees.
- [Get card types available for the account](https://docs.finup.io/api-reference/accounts/get-card-types-available-for-the-account.md)
- [List account transactions](https://docs.finup.io/api-reference/transactions/list-account-transactions.md): Filters and pagination are both optional; pagination defaults to page 1, 50 per page. `pagination.total_records` and `pagination.total_pages` are always null here — call POST /transactions/count with the same body for the totals.
- [Count filtered transactions](https://docs.finup.io/api-reference/transactions/count-filtered-transactions.md): Totals for the same filter body POST /transactions takes. Intended to be called in parallel with the page request.
- [Summarize filtered transactions](https://docs.finup.io/api-reference/transactions/summarize-filtered-transactions.md): Aggregates the whole filtered set, not just the current page. Card funding and same-account member transfers are net-zero within the account and are excluded from both spent and incoming.
- [Issue cards](https://docs.finup.io/api-reference/cards/issue-cards.md): Issues `quantity` cards on one BIN. `balance_type` is required and must be supported by the BIN.
- [List account cards](https://docs.finup.io/api-reference/cards/list-account-cards.md): Filters and pagination are both optional; pagination defaults to page 1, 50 per page. Money fields are decimal strings on this endpoint.
- [Get card details](https://docs.finup.io/api-reference/cards/get-card-details.md): Returns the full card, including PAN and CVV when the provider exposes them.
- [Deposit funds to card](https://docs.finup.io/api-reference/cards/deposit-funds-to-card.md): Balance cards only — a limit card has no balance to fund.
- [Withdraw funds from card](https://docs.finup.io/api-reference/cards/withdraw-funds-from-card.md): Balance cards only — a limit card has no balance to withdraw from.
- [Freeze cards](https://docs.finup.io/api-reference/cards/freeze-cards.md)
- [Unfreeze cards](https://docs.finup.io/api-reference/cards/unfreeze-cards.md)
- [Close cards](https://docs.finup.io/api-reference/cards/close-cards.md)

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.