---
title: "Validate phone numbers and retrieve additional information"
method: GET
path: "/score/phone/{phone}"
tags: ["Scoring"]
---

# Validate phone numbers and retrieve additional information

`GET /score/phone/{phone}`

## Request

- Base URL: `https://v2.greipapi.com`
- URL: `https://v2.greipapi.com/score/phone/{phone}`
- Auth: HTTP bearer

This method serves as an additional layer of protection in your system for validating phone numbers. It not only checks the syntax but also assesses the likelihood of the phone number being valid and operational.

By incorporating this scoring into your workflow, you can enhance fraud detection, reduce invalid inputs, and improve the overall quality of data captured.

## Path parameters

- `phone` string, required

## Query parameters

- `country_code` string, required
- `format` string
- `mode` string
- `source` string
- `user_id` string

## Response `200`

OK

- GreipJsonSuccessEnvelope
  - `success` boolean, required
  - `data` object, required: Endpoint-specific payload.
  - `execution_ms` integer, required

## Changes

- **2026-11-03** `5ef5b288383a`: 2 info
  - api tag `Scoring` added
  - added the media type `application/json` for the response with the status `200`
- **2026-10-19** `9346ce4dfd7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/greip/apis/greip-api/changes/score/phone/:phone/get.md)

---

[API](https://skmtc.dev/greip/apis/greip-api.md) - [All operations](https://skmtc.dev/greip/apis/greip-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greip/apis/greip-api/revisions/5ef5b288383a?raw)