$5 free Limited time. Sign up to activate. Get your $5 →
ArticleProduct updates

Contact feedback: tell us which numbers and emails worked

Three free endpoints let you report what happened when you used a Forager phone number, personal email or work email: connected or dead, valid or bounced, the right person or someone else.

Written by Justin Winter, Head of Growth Founder and growth executive across VC-backed startups and B2B SaaS.
Read the video (18 seconds, loops, no voiceover)
  1. Contact feedback. Tell us which contacts worked. Connected. Disconnected. Wrong person.
  2. Report each outcome with one request. Right after a call or a bounce, from your dialer or sequencer.
  3. Phones, personal emails and work emails. Connected or disconnected. Valid or invalid.
  4. Flag the wrong person, not just a dead number. The number works, but it isn't Jane.
  5. Report outcomes for free. Feedback requests use no credits.
On this page

Key takeaways

When you call a number or email an address that Forager returned, you can now tell us what happened. Three new feedback endpoints take the outcome: the number connected or it was dead, the email was valid or it bounced, and whether it reached the person you meant.

Send one POST after a call or a send. A dialer or sequencer can do it automatically, right after each call or bounce.

Three endpoints, one shape

The feedback loop: look up a contact, call or email it, then send the outcome to Forager's free feedback endpoint for phones, personal emails or work emails.
You contactedEndpointcontact_status
A phone numberPOST /feedback/phone_numbers/connected or disconnected
A personal emailPOST /feedback/personal_emails/valid or invalid
A work emailPOST /feedback/work_emails/valid or invalid

Each takes the contact and its contact_status. Optional fields add context: is_correct_person, person_id (the Forager person the contact came from) and name.

Send a report

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/feedback/phone_numbers/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number": "+12025550142", "contact_status": "disconnected", "person_id": 377104562}'

A stored report returns 201 with the record, its id and date_created. Each report is kept as its own record.

Phone numbers can be sent in any format; Forager normalizes them. The report bad data guide lists every response code.

Flag the wrong person, not just a dead contact

A number can ring and still be wrong. It may belong to someone else now, or to a namesake.

is_correct_person tells the two apart. Send false when the number works but it isn't the person you meant. A dead number and a live number for someone else are different problems, and the feedback keeps them apart.

Update, September 24, 2026: on the phone number endpoint, is_correct_person is optional. Only phone_number and contact_status are required, so a dialer can report a connection even when nobody confirmed who picked up. Leave it out when you don't know, and it is stored as unknown. That is different from false.

Wire it into your dialer or sequencer

The best time to report is the moment you know:

  • Dialers: after each call, send connected or disconnected, plus is_correct_person when the rep confirmed who answered.
  • Sequencers: on a hard bounce, send invalid for that work or personal email.
  • CRMs and data tools: when a user marks a contact as wrong, pass it on with the person_id.

What it costs and the limits

Feedback requests are free. They use no credits.

The three endpoints share 60 requests a minute per account. A burst above that gets 429, so queue reports and send them at a steady pace.

Update, November 2026: these endpoints are also how our guarantee works. Right contact every time, or your money back. Wrong or invalid contact? Report it and the credits are returned.

FAQ

Do feedback requests cost credits?

No. All three feedback endpoints are free.

What can I report?

Whether a phone number connected or was disconnected, and whether a personal or work email was valid or invalid. You can also say whether the contact reached the right person.

What is is_correct_person for?

It separates a contact that works but reaches someone else from one that is dead. Send false for the wrong person. On phone feedback you can leave it out when you don't know, and it is stored as unknown.

Is there a rate limit?

Yes. The three feedback endpoints share 60 requests a minute per account. Above that you get 429.

Do I get credits back for a wrong contact?

Yes, since November 2026. Report a wrong or invalid contact through these endpoints and the credits are returned.

See what Forager returns for your list

Send a sample of people you care about. We run it and show you what we find, contact by contact, so you can measure hit rate and connect rate yourself.

  • Feedback requests are free
  • Phones, personal and work emails
  • Report from your dialer or sequencer

#1 of 10 in Clay's 2026 test of mobile data providers Source: Clay

Justin Winter
Justin Winter Head of Growth at Forager. Founder and growth executive across VC-backed startups and B2B SaaS.
Start building

Put people, company and job data your users can act on inside your product

Send us a list. We run it, show you what we find, then talk volume and terms.

  • $5 free credits
  • No credit card
  • Run your sample
Platforms and teams that build on Forager
  • Clay
  • Juicebox
  • Nooks
  • Andela
  • HubSpot
  • SeekOut