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.
{
"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"
}
}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.What B2B Contact Append does
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.
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.
Charged per match
The 75 credits apply only when the person is found. A miss returns matched as false and leaves your balance untouched.
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.
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.
Fill in the field and run the lookup to see what comes back.
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)
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.
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| Plan | Per 1,000 credits | Per 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 |
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.
Related products
Email Finder
A verified work email from a first name, last name and company domain.
Prospect Search
Find people by title, seniority, location and company, 25 per search.
LinkedIn Profile Lookup
Headline, role history, education and skills from a public LinkedIn profile URL.
Run B2B Contact Append on your own data
Starter is $29 a month for 6,000 credits, enough for 80 matchs a month.