---
title: "Validate Phone"
method: POST
path: "/bizum/validate-phone"
tags: ["Bizum"]
---

# Validate Phone

`POST /bizum/validate-phone`

## Request

- Base URL: `https://api.monei.com/v1`
- URL: `https://api.monei.com/v1/bizum/validate-phone`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/monei/apis/monei-api-v1/docs/bizum/validate-phone/post.ts> (a function with typed inputs; its response is checked against the schema)

Validates if a phone number is registered with Bizum.

Use this endpoint to check if a customer's phone number can be used for Bizum payments
before attempting to process a payment. This helps provide a better user experience by
preventing failed payment attempts for non-registered numbers.

The response will indicate whether the phone number is valid for Bizum payments.

## Request body

- ValidateBizumPhoneRequest
  - `accountId` string, required: MONEI Account identifier.
  - `paymentId` string: Unique identifier for the payment.
  - `phoneNumber` string, required: Phone number in E.164 format.

## Response `200`

A successful response

- object
  - `isValid` boolean, required

## Other responses

- `400`: The request is incorrect or could not be processed
- `401`: Unauthorized error. Please check your auth credentials
- `404`: The specified resource was not found
- `422`: The request was well-formed but could not be processed due to semantic errors
- `500`: Unexpected server error
- `503`: The service is temporarily unavailable

---

[API](https://skmtc.dev/monei/apis/monei-api-v1.md) - [All operations](https://skmtc.dev/monei/apis/monei-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/monei/apis/monei-api-v1/revisions/50bc7df2aa43?raw)