---
title: "Predict banks for a customer based on their contact information"
method: POST
path: "/api/v1/bank-predictions"
tags: ["Bank Predictions"]
---

# Predict banks for a customer based on their contact information

`POST /api/v1/bank-predictions`

Predict banks for a customer based on their contact information

## Request body

- BankPredictionRequest
  - `merchant_id` string, uuid — Merchant ID. Defaults to the logged-in merchant if not provided. Required for admin tokens.
  - `customer_country` string, required — ISO 3166-1 alpha-2 country code
  - `phone_number` string — Customer phone number in international format
  - `email` string, email — Customer email address
  - `payment_request_id` string, uuid — Payment request ID for Shopify
  - `session_id` string — Session ID for WooCommerce

## Response `200`

Success

- BankPredictionResponse
  - `success` boolean, required
  - `data` object, required
    - `banks` unknown[], required
      - unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)