Skip to main content
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

Include identity signals that help Lev8 identify the contact owner. For example, add linkedin_url, a company or personal website, X/Twitter, YouTube, TikTok, Instagram, or GitHub links or handles. More specific owner signals improve match accuracy.

Example request

Response

On success, the response status is 200. 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 when result.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.