> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/payout-local/inquiry-account.md).

# Inquiry Account

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/inquiry-account

## Request

**Request Body**

```json
{
  "channelCode": "BCA",
  "channelInformation": {
    "accountNumber": "999966660001",
    "accountName": "Reforza Pivot"
  }
}
```

**Detail Parameter Request**

<table><thead><tr><th>Parameter</th><th width="109">Data Type</th><th width="114.65625">Character limit</th><th width="129">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>channelCode</td><td>String</td><td>1-30</td><td>M</td><td><p>Channel code for payout destination such as Bank, E wallet or other channels</p><p><br></p><p>List of Channel code can be accessed here</p><p><br><a href="/pages/VLaKKcjXG5xkE8l7BiiC">Channel Code</a></p></td></tr><tr><td>channelInformation</td><td>Object</td><td>-</td><td>M</td><td><br></td></tr><tr><td><ul><li>accountNumber</li></ul></td><td>String</td><td>1-60</td><td>M</td><td>Account Number of payout destination</td></tr><tr><td><ul><li>accountName</li></ul></td><td>String</td><td>1-60</td><td>M</td><td>Account Name of payout destination from Merchant</td></tr></tbody></table>

## Response

**Response Body**

```json
{
  "code": "00",
  "message": "OK",
  "data": {
    "uuid": "f4f3b3d0-fbff-414a-9ec1-f2c279b4e0c6",
    "merchantId": "e485e01b-ff59-4a47-bb7d-9b39064f3388",
    "inquiryResult": {
      "status": "WARNING",
      "detail": "The account name entered does not match the bank's records. Please check the account information and try again. Bank record: Dummy Simulation"
    }
  }
}
```

**Detail Parameter Response**

<table><thead><tr><th>Parameter</th><th width="111">Data Type</th><th width="129">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>String</td><td>M</td><td>Response code</td></tr><tr><td>message</td><td>String</td><td>M</td><td>Response description</td></tr><tr><td>data</td><td>Object</td><td>M</td><td><br></td></tr><tr><td><ul><li>uuid</li></ul></td><td>String</td><td>M</td><td>Unique Inquiry Account ID</td></tr><tr><td><ul><li>merchantId</li></ul></td><td>String</td><td>M</td><td>Unique merchant ID</td></tr><tr><td><ul><li>inquiryResult</li></ul></td><td>Object</td><td>O</td><td></td></tr><tr><td><blockquote><ul><li>Status</li></ul></blockquote></td><td>String</td><td>M</td><td><p>Inquiry status to indicate the result</p><p><br></p><p>Potential value</p><ul><li>VALID = requested account matched </li><li>WARNING = requested account is available, but the account might be mismatched. Please check detail for more information</li><li>INVALID = requested account is invalid or can’t be found</li><li>PENDING = inquiry account is still in progress</li></ul></td></tr><tr><td><blockquote><ul><li>detail</li></ul></blockquote></td><td>String</td><td>C</td><td><p>Only available if the status is WARNING, INVALID, and PENDING explains the reason below:</p><p><br></p><p>Warning:</p><ul><li>Account Name is not similar = "The account name entered does not match the bank's records. Please check the account information and try again. Bank record:{accountName from bank}"</li><li>Account Name is similar = “The account name entered is not an exact match. Please check the account information and try again. Bank record: {accountName from bank}”</li></ul><p></p><p>Invalid: </p><p>Account number not found.</p><p></p><p>Pending: </p><p>Inquiry in progress</p></td></tr></tbody></table>

## Tips! Storing Inquiry ID for future usage

{% hint style="info" %}
After you have successfully received a response from the Inquiry Account, you can store the <mark style="color:orange;">`inquiryId`</mark>.&#x20;

So whenever you want to create a Payout to the same Beneficiary Account, you don't need to hit the Inquiry Account API again, just pass <mark style="color:orange;">`inquiryId`</mark> on the payload [here](/pivot-docs/api-references/api-lists/payout-local/create-a-payout.md#request)
{% endhint %}