> 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/retrieve-inquiry-account.md).

# Retrieve Inquiry Account

## Method and URL

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

<mark style="color:orange;">`uuid`</mark> from the response body of the Inquiry Account

## 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></p><p>Invalid: </p><p>Account number not found.<br><br>Pending: </p><p>Inquiry in progress</p></td></tr></tbody></table>
