> ## Documentation Index
> Fetch the complete documentation index at: https://mobiska-docs.stimuluzdev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Account Lookup

> Verify and retrieve payment account information

Lookup and verify payment account details before processing a transaction.

## Request Body

<ParamField body="service_id" type="integer" required>
  Your service identifier
</ParamField>

<ParamField body="pan" type="string" required>
  Phone number or account number to lookup
</ParamField>

<ParamField body="nw" type="string" required>
  Network provider code (e.g., "MTN", "VODA", "AIRTELTIGO")
</ParamField>

## Example Request

```bash theme={null}
curl -X POST https://mobiska-api.stimuluzdev.com/payment_account_lookup \
  -H "Authorization: Basic YOUR_ENCODED_API_KEYS" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1,
    "pan": "0541840988",
    "nw": "MTN"
  }'
```

## Response

<ResponseField name="response_code" type="string">
  Status code of the request
</ResponseField>

<ResponseField name="response_message" type="string">
  Human-readable status message
</ResponseField>

<ResponseField name="response_data" type="object">
  <Expandable title="Toggle object">
    <ResponseField name="account_name" type="string">
      Name associated with the account
    </ResponseField>

    <ResponseField name="account_status" type="string">
      Status of the account (e.g., "active", "inactive")
    </ResponseField>

    <ResponseField name="account_type" type="string">
      Type of the account (e.g., "mobile\_money", "bank")
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "response_code": "000",
  "response_message": "Account found",
  "response_data": {
    "account_name": "John Doe",
    "account_status": "active",
    "account_type": "mobile_money"
  }
}
```

<Note>
  Account lookup is recommended before initiating payments to ensure the recipient account is valid and active.
</Note>