---
title: Detect Phones Numbers API
slug: detect-phone-numbers
url: https://apyhub.com/sharpapi/service/detect-phone-numbers
provider: SharpAPI
categories: [Data Validation, Developer Tools]
auth: api_key
---

# Detect Phones Numbers API

Detect phone numbers in free-form text and poll job status for parsed_number and detected_number results. Useful for cleanup and validation workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/sharpapi/api/v1/content/detect_phones` | What it does Submits an asynchronous job to detect phone numbers from the provided content. The res… | 50 |
| GET | `/sharpapi/api/v1/content/detect_phones/job/status/:job_id` | What it does Returns the current status of a Detect Phone Numbers job identified by jobid. The resp… | 1 |

## About

## What it does
Phone Number Detector finds phone numbers in text and returns the detected results asynchronously. Send a content string, get back a job_id and a status_url, then poll the job status endpoint until the job completes.

Use it when you need to scan user-generated text, notes, tickets, chat logs, or imported documents for phone numbers without building your own parsing logic. The submitted content is the only input for the detection job, so it fits cleanly into automated validation or enrichment workflows.

When the job finishes, the status response includes a data object with attributes.status and attributes.result. Each result item contains parsed_number and detected_number, letting you compare the normalized number with the original value that was found in the text.

Phone Number Detector is a good fit for contact cleanup, lead processing, compliance checks, and any workflow where phone numbers need to be identified from free-form text before further processing.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/sharpapi/service/detect-phone-numbers