# TrestleIQ · Real contact

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.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `trestleiq/contacts/verify`
- Page: https://spiral.ai/tools/alexandria/trestleiq/contacts/verify

## Pricing

Up to $0.17459 per run.

## Limits

- 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

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `name` (required) | text |  | — | Person name to grade. Example John Doe. |
| `phone` (required) | text |  | — | Phone number from the lead. Example 4259853735. |
| `email` | text |  | — | Email to grade. Optional on this route. Example john.doe@example.com. |
| `add_ons` | text |  | — | Comma-separated add-ons: email_checks_deliverability, email_checks_age, litigator_checks. Each is an extra $0.005. |
| `last_name` | text |  | — | Family name. Example Doe. |
| `source_id` | text |  | — | Optional campaign or cohort id, at most 255 characters. Letters, numbers, spaces, and . _ - : / \| #. It cannot begin with -. |
| `first_name` | text |  | — | Given name. Example John. |
| `ip_address` | text |  | — | IPv4 or IPv6 captured with the lead. Example 192.0.0.1. |
| `address.city` | text |  | — | City. Example Lynden. |
| `business.name` | text |  | — | Business name. Example The Golden Company. |
| `address.state_code` | text |  | — | Two-letter state code or the full state name. Example WA. |
| `address.postal_code` | text |  | — | Five-digit ZIP or ZIP+4. Example 98229. |
| `address.country_code` | text |  | — | ISO-3166 alpha-2 country code of the address. Example US. |
| `address.street_line_1` | text |  | — | First street line. Example 100 Syrws St. |
| `address.street_line_2` | text |  | — | Second street line, such as a unit. |

## Example

```bash
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>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=trestleiq%2Fcontacts%2Fverify

## Common questions

### TrestleIQ · Real contact

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

