Skip to content

Email append API: emails from a name and address

Send a name and US postal address and get the email addresses on file for that person. Every address comes back with a validation status. 10 credits per match, no charge when nothing is found.

10 credits / matchEnrichCSV bulkMCP
POST/v1/email-append
{
  "success": true,
  "data": {
    "match": true,
    "person": {
      "first_name": "Jordan",
      "last_name": "Avery"
    },
    "address": {
      "street": "1200 Example Ave",
      "city": "Austin",
      "state": "TX",
      "zip": "78701"
    },
    "emails": [
      {
        "email": "jordan.avery@example.com",
        "validation_status": "deliverable"
      },
      {
        "email": "javery@example.com",
        "validation_status": "risky"
      }
    ],
    "email_count": 2,
    "deliverable_count": 1
  },
  "meta": {
    "credits_used": 10,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

matchMatchWhether at least one email was found for the person. Only matched records are charged.
emailsEmailsThe addresses found. Each item carries the email and its validation status.
email_countEmails foundThe number of addresses returned for this record.
deliverable_countDeliverableHow many of the returned addresses validated as deliverable.
personPersonThe first and last name the append was matched on.
addressPostal addressThe US postal address used as the match key.
[02/Capabilities]

What Email Append does

01

Postal records in, emails out

The match key is a name plus a US street address, the data a mail file or billing system already holds. No phone number or existing email is needed.

02

Validated before you see it

Each appended address is run through validation and labeled with a status such as deliverable or risky. Filter on that status and load only the addresses you are willing to send to.

03

More than one address when available

People keep several inboxes. When the record holds more than one email, all of them are returned so you can choose the one that validated.

04

Pay for matches only

Rows where no email is found use no credits, so the bill follows the match rate of your file. The response marks each row as matched or not.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/email-append10 credits / match

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/email-append \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jordan","last_name":"Avery","address":"1200 Example Ave","city":"Austin","state":"TX"}'
Endpoint
POST /v1/email-append
Base URL
https://api.1lookup.dev
Request
first_namelast_nameaddresscitystatezip?
Price
10 credits / match
Coverage
US
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Add email to a direct mail file

Run the names and addresses you already mail to. Matched records can get an email that arrives the same week as the postcard.

Restore contact with lapsed customers

Old accounts often hold a postal address and a dead email. Append a current address so service notices and renewal reminders reach the customer again.

Complete records from offline signups

Paper forms, in-store signups and phone orders capture a postal address more reliably than an email. Fill the gap in bulk afterward.

Email Append has permitted-use restrictions. Do not use it for decisions covered by the FCRA, such as credit, employment, tenant or insurance screening, or to harass or track down a private person for personal reasons. An appended email is not consent: you need a lawful basis before you send marketing to it.

[06/Cost]

10 credits / match

Credits come with your plan and work on every product. You are charged only when a match is found. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 matchs
Starter $29/mo$4.83$48.33
Growth $99/mo$3.96$39.60
Pro $299/mo$3.32$33.22
Scale $799/mo$2.66$26.63
[07/FAQ]

Email Append questions

What do I send?

A first and last name plus a street address, city and state, with ZIP code as an optional extra. One request describes one person at one address.

What is the cost per record?

Ten credits for each record where at least one email is found. Records with no match are free, so you can run a full file without paying for the misses.

Is it available for addresses outside the US?

No. Matching relies on US postal addresses, so other countries are not covered.

Can I market to the emails I get back?

An appended email does not come with consent. You still need a lawful basis to send marketing to it, and commercial email rules such as CAN-SPAM apply. None of this is legal advice.

Are the appended addresses verified?

Every address is validated before it is returned and carries its own status. An address marked risky or undeliverable is still shown, so you can see what was on file and decide what to do with it.

[ Validate ][ Enrich ]
[Get started]

Run Email Append on your own data

Starter is $29 a month for 6,000 credits, enough for 600 matchs a month.

[ Screen ][ Scrape ]