Skip to main content
POST
Submit phone-number verification feedback

When to use this endpoint

You learned whether a phone number Forager returned connected or was disconnected on a live call 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 phone-number verification feedback.

phone_number
string
required
write-only
contact_status
enum<string>
required
  • connected - Connected
  • disconnected - Disconnected
Available options:
connected,
disconnected
is_correct_person
boolean | null
name
string | null
Maximum string length: 255
person_id
integer | null

Response

Response serializer for created phone feedback rows.

id
integer
required
read-only
phone_number
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