Skip to content

B2B contact append API: work email, title and seniority

Send a first name, last name and company. When the person is matched you get a verified work email, job title, seniority, department and LinkedIn URL. 75 credits per match, nothing for a miss.

75 credits / matchEnrichCSV bulkMCP
POST/v1/b2b-contact-append
{
  "success": true,
  "data": {
    "matched": true,
    "first_name": "Jordan",
    "last_name": "Avery",
    "work_email": "jordan.avery@example.com",
    "email_status": "verified",
    "job_title": "Director of Revenue Operations",
    "seniority": "director",
    "department": "operations",
    "linkedin_url": "https://www.linkedin.com/in/jordan-avery-example",
    "company": {
      "name": "Northwind Logistics",
      "domain": "northwind.example"
    }
  },
  "meta": {
    "credits_used": 75,
    "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.

matchedMatchWhether the person was found at the company. Only a true result is charged.
work_emailWork emailThe person's business email address at the matched company.
email_statusEmail statusConfirms the address passed verification before it was returned.
job_titleJob titleThe person's current title as text.
senioritySeniorityA normalized level such as c-suite, vp, director, manager or individual.
departmentDepartmentThe function the person works in, for example sales, operations or engineering.
linkedin_urlLinkedIn URLThe person's public profile, which you can pass to other LinkedIn-based lookups.
[02/Capabilities]

What B2B Contact Append does

01

A verified work email

The address in a match has passed verification before it reaches you, and email_status says so. You are not sent a pattern guess to test on your own sending domain.

02

Title, seniority and department

Alongside the email you get the raw job title plus normalized seniority and department values. Those two fields are what lead routing and segmentation rules key on.

03

Charged per match

The 75 credits apply only when the person is found. A miss returns matched as false and leaves your balance untouched.

04

Company by name or domain

Identify the employer with a company name or a website domain. A domain is less ambiguous, so send it whenever you have one.

[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/b2b-contact-append75 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/b2b-contact-append \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jordan","last_name":"Avery","company":"northwind.example"}'
Endpoint
POST /v1/b2b-contact-append
Base URL
https://api.1lookup.dev
Request
first_namelast_namecompany
Price
75 credits / match
Coverage
Global
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

Finish an event attendee list

Badge scans and attendee exports often stop at name and company. Append the work email and title so the follow-up can go out the same week.

Repair incomplete CRM contacts

Find records with a name and an account but no email or title, run them as a bulk job and write the matches back.

Qualify leads who signed up with a personal address

When a form captures a name, a company and a webmail address, append the work email and seniority so sales can judge the lead properly.

Make a Prospect Search result contactable

Prospect Search gives you names, titles and companies without emails. Run the people you choose through this product to get an address you can send to.

Business contact data for B2B use. It is not for decisions about credit, employment, tenancy or insurance. Email and privacy rules such as CAN-SPAM and GDPR may apply to your outreach. Not legal advice.

[06/Cost]

75 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$363
Growth $99/mo$3.96$297
Pro $299/mo$3.32$249
Scale $799/mo$2.66$200
[07/FAQ]

B2B Contact Append questions

Which inputs does a contact append need?

A first name, a last name and the company, given as a name or a domain. No email, phone number or profile URL is required.

How often will I get a match?

It depends on your list. Coverage is global, but people at very small companies and people who changed jobs recently are harder to find. When there is no match the response says so and you are not charged.

What does it cost?

75 credits per matched contact. Unmatched requests are free, and so is repeating a request you already made in the last 7 days.

How is this different from Email Finder?

Email Finder returns a verified work email from a name and domain for 5 credits per match. B2B Contact Append adds job title, seniority, department and LinkedIn URL, and accepts a company name when you do not know the domain.

Are there limits on how I can use the data?

Use it for business-to-business sales, marketing and CRM upkeep. Do not use it for credit, employment, tenant or insurance decisions. Outreach rules such as CAN-SPAM and GDPR may apply depending on the recipient, and meeting them is your responsibility. Treat this as general guidance, not legal advice.

[ Validate ][ Enrich ]
[Get started]

Run B2B Contact Append on your own data

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

[ Screen ][ Scrape ]