1.1¢ per lookup, from

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.

One TaskFuel account and prepaid balance. Connect your agent and it shows the price before it pays.

Works with

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.
OptionPrice & billingChoose it forGood to knowAccess
Twilio LookupThrough TaskFuel$0.011 to $0.051 / lookupPer lookup, with no monthly planThe 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 LookupOwn Twilio accountProvider reference$0.008 / line type lookupPer requestSIM 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
NumverifyOwn Numverify accountProvider referenceFree, then $14.99 / monthMonthly planFree: 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

Phone number lookup API: what your agent gets.

Currently available through Twilio Lookup. Your AI picks the one that fits and checks the exact price before it pays.

  • Check validity, carrier and line type

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

    $0.011 / lookup
  • Add SIM swap and call forwarding

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

    $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.

    $0.05 / lookup

Support line lookup, tested.

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.

TaskFuel test run ·

Charged $0.062

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.
Data from
Twilio Lookup

What came back

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

Two dated lookups of one number.

Try the API request Quote first, then run

1. Check the price

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code. 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.

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 · Job polling and timeout recovery

Try it in your next task.

Sign in to TaskFuel and copy the connection prompt into your agent. Approve the connection, then ask for the work you need.

01

Name the task

Tell your agent what the output needs to contain.

02

See the price

Your agent shows the provider and price before spending.

03

Review the response

Check the output against your task. The call reports its cost and remaining balance.

When to use it.

Cleaning a lead list

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.

Account recovery

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.

An unknown number

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.

Good 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.

Your agent can do things it couldn’t this morning.

$1 in free credit, no card required.

Start for Free