# Phone number lookup API

Check a number before you call or text it.

Give your agent a phone number and get its carrier, line type and validity back. A second lookup adds SIM swap and call forwarding fields.



Provider in the worked example: Twilio Lookup.

Price shown for this route: 1.1¢ per lookup, from.

## Choose how your agent looks up a phone number.

A carrier lookup costs about a cent anywhere. The fraud signals are where access and price differ.

Prices and access checked on 12 November 2026.

| Option | Price and billing | Strength | Good to know | Access |
| --- | --- | --- | --- | --- |
| Twilio Lookup (Through TaskFuel) | $0.011 to $0.051 / lookup. Per lookup, with no monthly plan. The higher price adds SIM swap and call forwarding. | Fraud signals with a posted price, from the same balance as your other tools. | Fraud signals depend on carrier coverage. | TaskFuel |
| Twilio Lookup (Own Twilio account) | $0.008 / line type lookup. Per request. SIM swap and call forwarding: price not published, contact sales. | Line type below the TaskFuel price, with basic validation free. | SIM swap and call forwarding need a sales conversation. | Direct |
| Numverify (Own Numverify account) | Free, then $14.99 / month. Monthly plan. Free: 100 requests a month. Basic: 5,000 requests. | Validation, carrier and line type on a free plan. | Monthly request limits, and no fraud signals are listed. | Direct |

- [Twilio Lookup: provider reference](https://taskfuel.ai/pricing/). Checked 2026-11-12.
- [Twilio Lookup: provider reference](https://www.twilio.com/en-us/user-authentication-identity/pricing/lookup). Checked 2026-11-12.
- [Numverify: provider reference](https://numverify.com/product). Checked 2026-11-12.


## What it can do

### Check validity, carrier and line type

Check a number’s validity, country, carrier and line type: mobile, landline, VoIP or toll-free.

Price: $0.011 / lookup.

### Add SIM swap and call forwarding

The fraud lookup returns the carrier fields plus SIM swap and call forwarding objects.

Price: $0.051 / lookup.

### Check iMessage and FaceTime

A separate lookup checks a US number for iMessage and FaceTime and returns a token to poll for the result. It was not part of our test.

Price: $0.05 / lookup.


## A real example

Tested on 2026-11-12 through Twilio Lookup.

Both lookups identified a valid toll-free line. The fraud lookup added SIM swap and call forwarding fields, which came back with error codes and no data.

Your agent asked: Look up the toll-free support number (800) 275-2273. Tell me its line type and carrier, and whether a SIM swap or call forwarding shows.

Returned in this test:

- Number: (800) 275-2273 · United States · valid
- Line type: Toll-free · Infobip TFN - Toll-Free - Zipwhip
- SIM swap: No data · error 60606
- Call forwarding: No data · error 60607

Charged in this test: $0.062.

Two dated lookups of one number.




## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. This is the fraud lookup from the test. The plain carrier lookup posts the same body to /api/v1/phone/lookup and costs $0.011.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://blockrun.ai/api/v1/phone/lookup/fraud",
  "method": "POST",
  "body": {
    "phoneNumber": "+18002752273"
  },
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

Read line_type_intelligence for the carrier and line type. sim_swap and call_forwarding hold a value or an error_code.



[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Sort numbers by line type before you reach out.

Ask your agent to look up each number and group them as mobile, landline, VoIP or toll-free, keeping the carrier for each.

### Look for a SIM swap before sending a code.

The fraud lookup returns SIM swap and call forwarding fields. Coverage depends on the number’s carrier.

### See what kind of line texted you.

Paste the number into a request and read its line type and carrier before you call it back.




## Questions

### What is a phone number lookup API?

A request that takes a phone number and returns facts about it: validity, country, carrier and line type. Extra lookups add SIM swap, call forwarding and caller name fields.

### Do I need a Twilio account?

No. Your agent pays from your TaskFuel balance, so there is nothing else to sign up for.

### What does a lookup cost?

Our carrier lookup cost $0.011 and the lookup with fraud signals $0.051 on 12 November 2026. Your agent shows the price for your own request before it pays.

### What do the fraud signals add?

SIM swap and call forwarding fields on top of the carrier fields. On our toll-free test both returned error codes and no data. We tested no mobile number.

### Can it check iMessage?

A separate lookup checks US numbers for iMessage and FaceTime at $0.05 and returns a token to poll.

### How is this different from the carrier lookup API guide?

That guide tests a carrier and line type lookup on one example number. This guide adds the fraud lookup and compares access and price.

## Related tool guides

- [Read a number’s carrier and line type](https://taskfuel.ai/tools/carrier-lookup-api/)
- [Give your agent a phone number to text and call from](https://taskfuel.ai/tools/agent-phone-number/)
- [Check an email address before sending](https://taskfuel.ai/tools/verify-email-addresses/)
- [Find a work email for the same contact](https://taskfuel.ai/tools/find-email-addresses/)


## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/phone-number-lookup-api/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
