Skip to main content
POST
Submit personal-email verification feedback

When to use this endpoint

You learned whether a personal email Forager returned is valid or invalid, for example from a bounce, and want to send that outcome back. Free, rate limited to 60 requests per minute per account across the three feedback endpoints.

Example request

cURL
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.

Example response

201 (illustrative values)

Credits

This endpoint is free: it does not use credits. See API credits and pricing.

Authorizations

X-API-KEY
string
header
required

Path Parameters

account_id
integer
required

Body

Request serializer for personal/work email verification feedback.

email
string<email>
required
write-only
contact_status
enum<string>
required
  • valid - Valid
  • invalid - Invalid
Available options:
valid,
invalid
is_correct_person
boolean | null
name
string | null
Maximum string length: 255
person_id
integer | null

Response

Response serializer for created personal- and work-email feedback rows.

id
integer
required
read-only
email
string
required
read-only
contact_status
string
required
read-only
is_correct_person
boolean | null
required
read-only
name
string | null
required
read-only
person_id
integer | null
required
read-only
date_created
string<date-time>
required
read-only
Last modified on November 1, 2026