Read the video (18 seconds, loops, no voiceover)
- Contact feedback. Tell us which contacts worked. Connected. Disconnected. Wrong person.
- Report each outcome with one request. Right after a call or a bounce, from your dialer or sequencer.
- Phones, personal emails and work emails. Connected or disconnected. Valid or invalid.
- Flag the wrong person, not just a dead number. The number works, but it isn't Jane.
- 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
| You contacted | Endpoint | contact_status |
|---|---|---|
| A phone number | POST /feedback/phone_numbers/ | connected or disconnected |
| A personal email | POST /feedback/personal_emails/ | valid or invalid |
| A work email | POST /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
connectedordisconnected, plusis_correct_personwhen the rep confirmed who answered. - Sequencers: on a hard bounce, send
invalidfor 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