Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

TrestleIQ · Real contact

trestleiq/contacts/verify

Find companies, people and contact details with TrestleIQ · Real contact from Alexandria through one Spiral API key. Grade one lead across phone, email, address, and IP. name and phone are required. email is how this route verifies an address; there is no separate email route. A body with no verification costs nothing. Use phones/validate for carrier and line type without a grade. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

Up to $0.17459 per run.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
name requiredtext—

Person name to grade. Example John Doe.

phone requiredtext—

Phone number from the lead. Example 4259853735.

emailtext—

Email to grade. Optional on this route. Example [email protected].

add_onstext—

Comma-separated add-ons: email_checks_deliverability, email_checks_age, litigator_checks. Each is an extra $0.005.

last_nametext—

Family name. Example Doe.

source_idtext—

Optional campaign or cohort id, at most 255 characters. Letters, numbers, spaces, and . _ - : / | #. It cannot begin with -.

first_nametext—

Given name. Example John.

ip_addresstext—

IPv4 or IPv6 captured with the lead. Example 192.0.0.1.

address.citytext—

City. Example Lynden.

business.nametext—

Business name. Example The Golden Company.

address.state_codetext—

Two-letter state code or the full state name. Example WA.

address.postal_codetext—

Five-digit ZIP or ZIP+4. Example 98229.

address.country_codetext—

ISO-3166 alpha-2 country code of the address. Example US.

address.street_line_1text—

First street line. Example 100 Syrws St.

address.street_line_2text—

Second street line, such as a unit.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "trestleiq/contacts/verify",
    "input": {
      "name": "<name>",
      "phone": "<phone>"
    }
  }'

Frequently asked questions

How much does TrestleIQ · Real contact cost?

Up to $0.17459 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use TrestleIQ · Real contact through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "trestleiq/contacts/verify"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use TrestleIQ · Real contact?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use TrestleIQ · Real contact?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.