Skip to main content
POST
Report a wrong phone number
Use this endpoint when one of your users finds that a number Pipecorn enriched is wrong: it belongs to someone else, or it no longer works. Pipecorn removes the number from the contact and, by default, searches for another one with the providers that did not give the wrong number.

Flow

  1. Send the contact’s linkedin_url, the wrong phone and a reason.
  2. The response says whether a new search started (replacement: "searching").
  3. Poll status_url until status is finished, or wait for the webhook. It carries the new number in phones, or no number when none was found.

Credits

Reporting is free. The new search costs 30 credits, like any phone enrichment, and only when it finds a number. Send "find_replacement": false to report the number without searching.

Authorizations

X-API-KEY
string
header
required

Your API key

Headers

Idempotency-Key
string

A unique value you generate per operation, such as a UUID. Retrying with the same key and the same body returns the stored response instead of running the request again, so a retry after a timeout never charges twice. Successful responses are kept for 24 hours; a failed request is not stored and can be retried with the same key.

Maximum string length: 255
Example:

"4f1c2e9a-8a7d-4c1b-9f63-2d6e0b5a7c11"

Body

application/json
linkedin_url
string
required

LinkedIn profile URL of the contact, as sent to the enrichment.

Example:

"https://www.linkedin.com/in/william-hewish"

phone
string
required

The wrong number, as Pipecorn returned it. Any international format works: spaces, dots, dashes and parentheses are ignored.

Example:

"+33612345678"

reason
enum<string>
required

wrong_person: the number belongs to someone else. disconnected: the number no longer works.

Available options:
wrong_person,
disconnected
find_replacement
boolean
default:true

Search for another number. Send false to only report the number.

webhook_url
string<uri>

Where to send the result of the new search. Defaults to the webhook_url of the original enrichment.

Response

The number is reported

enrichment_id
string<uuid>

The contact's enrichment ID, for GET /contacts/{id}

reported
boolean

Always true

replacement
enum<string>

searching: a new phone search is running. other_mobile_kept: the contact still has another mobile, so no search ran. not_allowed: your plan or role does not allow phone enrichment. insufficient_credits: fewer than 30 credits left. skipped: you sent find_replacement: false.

Available options:
searching,
other_mobile_kept,
not_allowed,
insufficient_credits,
skipped
status_url
string<uri>

GET /contacts/{id} for this contact