---
title: "Simulate balance inquiry"
method: POST
path: "/cards/transaction_simulations/financial/balance_inquiry"
tags: ["Card Transaction Simulations"]
---

# Simulate balance inquiry

`POST /cards/transaction_simulations/financial/balance_inquiry`

## Request

- Base URL: `https://api-sandbox.synctera.com/v0`
- URL: `https://api-sandbox.synctera.com/v0/cards/transaction_simulations/financial/balance_inquiry`
- Auth: HTTP bearer

Simulate a `pindebit.balanceinquiry` type transaction by sending a POST request to the `/simulate/financial/balanceinquiry` endpoint.

## Request body

- BalanceInquiryRequestModel
  - `account_type` 'checking' | 'credit' | 'savings', required
  - `card_acceptor` CardAcceptorModel, required
    - `address` string
    - `city` string
    - `country` string
    - `ecommerce_security_level_indicator` string
    - `mcc` string
    - `name` string
    - `partial_approval_capable` boolean
    - `state` string: Two-Letter USPS State Abbreviation
    - `zip` string
  - `card_id` string, uuid, required
  - `mid` string, required
  - `network_fees` NetworkFeeModel[]
    - `amount` integer, required: The amount of the fee in the smallest whole denomination of the applicable currency (eg. For USD use cents)
    - `credit_debit` 'C' | 'D': C = credit; D = debit
    - `type` 'ACQUIRER_FEE' | 'CROSS_BORDER_ISSUER_FEE' | 'CUR_CONV_CARDHOLDER_FEE' | 'CUR_CONV_ISSUER_FEE' | 'INTERCHANGE_FEE' | 'ISSUER_FEE' | 'PINDEBIT_ASSOC_FEE' | 'SWITCH_FEE', required
  - `pin` string

## Response `201`

Success

- SimulationResponseModel

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden error
- `500`: Internal server error

---

[API](https://skmtc.dev/synctera/apis/synctera-api.md) - [All operations](https://skmtc.dev/synctera/apis/synctera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synctera/apis/synctera-api/revisions/1bec78916922?raw)