---
title: "Predict Provider"
method: POST
path: "/v2/predict-provider"
tags: ["toolkit"]
---

# Predict Provider

`POST /v2/predict-provider`

## Request

- Base URL: `https://api.sandbox.pawapay.io`
- URL: `https://api.sandbox.pawapay.io/v2/predict-provider`
- Auth: HTTP bearer

## Request body

- MsisdnInput
  - `phoneNumber` string, required: The phone number (MSISDN) to predict the provider of. Must contain the country code. The input will be sanitized by: * removing the leading + sign * removing all whitespace * removing non-numeric characters

## Response `200`

Provider prediction was completed

- ProviderPrediction
  - `country` string, required: The country in which the payment was initiated. Format is ISO 3166-1 alpha-3, three character country code in upper case. Read more from [Wikipedia](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements).
  - `provider` string, required: The provider represents the mobile money operator or processor that can process payments. Find here a list of all the supported [providers](/v2/docs/providers). The [active configuration](/v2/api-reference/toolkit/active-configuration) endpoint provides the list of provider configured for your account. You can use the [predict provider](/v2/api-reference/toolkit/predict-provider) enpoint to predict the provider to use based on the phone number (MSISDN).
  - `phoneNumber` string, required: The correctly formatted phone number (MSISDN) from your original request that is in a valid format for the rest of the PawaPay Merchant API.

## Other responses

- `400`: Request was rejected due to incompatibility with PawaPay API specification
- `401`: Authentication failed. Make sure you have added the API token into the header. If using signatures, make sure they are valid.
- `403`: Authorization failure. Please check your authentication token.
- `500`: An unknown failure has occurred.

---

[API](https://skmtc.dev/pawapay/apis/pawapay-merchant-api-v2.md) - [All operations](https://skmtc.dev/pawapay/apis/pawapay-merchant-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/pawapay/apis/pawapay-merchant-api-v2/revisions/4556d2ec2141?raw)