---
title: "Get Account Credit Balance"
method: POST
path: "/pws/pws_get_account_credit_balance/"
tags: ["Credit account status"]
---

# Get Account Credit Balance

`POST /pws/pws_get_account_credit_balance/`

## Request

- Base URL: `https://api.uat.paymentology.com/ppws/api`
- URL: `https://api.uat.paymentology.com/ppws/api/pws/pws_get_account_credit_balance/`
- Auth: none declared

This web service gets the current credit balance summary for the credit account

## Request body

- PwsGetCreditCurrentBalanceModel: View the credit Balance for the account
  - `acc_id` integer, required: account Id
  - `api_call_unique_identifier` string, required: Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required: Unique identifier for the client which Paymentology will provide at outset
  - `user_id` string: User Id of the Customer who triggered the API request.
  - `remarks` string: Remarks for API request

## Response `200`

Successful Response

- GetCurrentBalanceResponse
  - `header` GetCurrentBalanceHeader
    - `error_id` integer: error id
    - `error_desc` string: error message
  - `body` GetCurrentBalanceBody[]
    - `acc_id` integer: account Id
    - `merchant_type_category` integer: Merchant Type Category
    - `mcc_category_desc` string: Merchant Type Category Description
    - `mcc_group` string: MCC group
    - `mcc_group_desc` string: Merchant Type Group Description
    - `mcc_code` integer: MCC Code
    - `mcc_code_desc` string: Merchant Code Description
    - `debits_actual` number: Total amount of credit used and posted (purchases, withdrawals, etc.)
    - `debits_blocked` number: Total amount of credit used (for purchases, withdrawals, etc.) but not yet posted
    - `credits_actual` number: Total amount of credit used and posted (purchases, withdrawals, etc.)
    - `credits_blocked` number: Total amount of credit used (for purchases, withdrawals, etc.) but not yet posted
    - `interest_actual` number: Interest posted
    - `interest_blocked` number: Interest pending
    - `include_interest_in_available_amt` boolean: Indicator if the interest owed is counted against the available credit line
    - `other_charges_actual` number: Non-Interest Charges posted
    - `other_charges_blocked` number: Non-Interest Charges pending
    - `credit_limit_amount` number: Total size of the credit line established for the card in the given Merchant Category
    - `credit_limit_effective_date` string, date-time: The effective date the credit line in the given Merchant Category was established
    - `credit_available` number: Total credit yet available considering posted and pending transactions, interest, and loyalty points in the given Merchant Category -- This is HOW MUCH the CARDHOLDER CAN SPEND RIGHT NOW in the given Merchant Type Category
    - `total_outstanding_balance` number
    - `overdraft` number: Overdraft available in the given Merchant Category
    - `cre_dt` string, date-time: The date/time of the most recent change of the record

## Other responses

- `404`: Webservices does not exist
- `500`: Internal Server error

## Changes

- **2026-11-03** `73c2771493b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paymentology/apis/payapi-docs/changes/pws/pws_get_account_credit_balance/post.md)

---

[API](https://skmtc.dev/paymentology/apis/payapi-docs.md) - [All operations](https://skmtc.dev/paymentology/apis/payapi-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/payapi-docs/revisions/73c2771493b1?raw)
