Skip to content
PGSwift Docs
Documentation/Check Inquiry Status

Check Inquiry Status

Use this API to check the status of an inquiry request

POST /api/check/inquiry

Request

NameTypeRequiredDescription
merchant_transaction_idstringtrueMerchant-provided transaction identifier.
{
  "merchant_transaction_id": "INQ12300456"
}

Response

NameDescription
statusRequest status indicator. true indicates success, false indicates failure.
data.statusCurrent inquiry status: pending, valid (approved, awaiting transfer), processing, success, fail
data.merchant_transaction_idMerchant-provided transaction identifier.
data.amountTransaction amount as a string with 2 decimal places (e.g., "100000.00").
data.bank_codeBank code used for the transaction.
data.transfer_typeTransfer type used: bifast or rtol.
data.account_numberAccount number used in the transaction.
data.reasonReason for transaction failure or status update (can be null). Inquiry expired when the inquiry expired before a transfer was made. See Expired Inquiries.
data.service_fee_finalFinal transaction fee applied.
data.similarity_scoreName similarity score from 0 to 100 between the name in your request and the account holder name returned by the bank. 0 when the bank returned no name. null when name validation is off for your account, when the bank inquiry failed, or for inquiries created before the score was recorded.
data.trigger_sourceWho decided the name check: auto_approve (score at or above your auto-approve threshold), auto_reject (score below your auto-reject threshold with auto-reject in Enforce mode; reason is Rejected), admin_telegram (a reviewer decided via Telegram; a rejection has reason Rejected), admin_dashboard (a reviewer approved it or marked it as failed from the dashboard while it was held; Mark as Failed has reason Marked as Failed). null while the inquiry is held (for review or by the amount threshold), after it expired without a decision, or when similarity_score is null.
{
    "status": true,
    "data": {
        "status": "success",
        "created_at": "2025-01-01T00:00:00.000000Z",
        "updated_at": "2025-01-01T12:00:00.000000Z",
        "merchant_transaction_id": "INQ12300456",
        "amount": "100000.00",
        "bank_code": "009",
        "transfer_type": "bifast",
        "account_number": "00000000",
        "reason": "",
        "service_fee_final": "5500.00"
    }
}

Expired Inquiries

An inquiry that is still pending or valid when its 30-minute window ends is expired. There is no separate expired status. An expired inquiry returns:

  • data.status: fail
  • data.reason: Inquiry expired

Use data.reason to tell an expired inquiry apart from other failures. Webhooks report the same outcome as described in Disbursement Expired Webhook.

© 2026 PGSwift. All rights reserved.