POST /v1/contact-search searches for one email address or phone number and returns a JSON response.
Headers
Request body
The complete request body must be at most 1 MiB. Unknown fields, malformed JSON, and multiple JSON objects are rejected.
Write the objective
Example request
Response
On success, the response status is200. Idempotency-Key contains the supplied or server-generated retry key, X-Request-Id contains the lev8 request ID, and Cache-Control is no-store.
Clients should treat
result.content as not found when it is null, empty, or contains only whitespace. The response contains only the documented fields; upstream error bodies and internal request identifiers are not exposed.
Billing behavior
Lev8 reserves the configured price for one lookup before contacting the search service. The request is charged only whenresult.content contains a non-empty result; a completed lookup with no result releases the reservation. Your Lev8 contact will provide the enabled contact types and applicable pricing.
The success response is written only after settlement succeeds. An upstream or response-protocol failure returns 500 internal_error and releases the reservation when the billing service is available.
Repeating the same completed request with the same API key, Idempotency-Key, and body returns the stored response without another upstream call or charge.
Errors
Errors use the standard error envelope.