Skip to main content
POST
Unlock contact phone numbers

Authorizations

Authorization
string
header
required

Send the full Business API key from Settings -> API Keys, for example Authorization: Bearer sk_your_api_key.

Headers

x-call-source
enum<string>

Identify the caller as api or agent for usage attribution. Defaults to api when omitted.

Available options:
api,
agent

Body

application/json

Batch phone enrichment request with optional event context.

personnel_ids
string[]
required

Lensmor personnel identifiers selected for this batch operation.

Required array length: 1 - 2000 elements
Example:
event_id
string

Optional Lensmor event identifier returned as id or eventId. When omitted, event membership validation is skipped.

Required string length: 1 - 100
Example:

"26855"

Response

Phone unlock submission accepted, or completed with no chargeable work

Email or phone unlock submission outcome, including accepted work and skipped records.

status
enum<string>
required

accepted when an asynchronous task was created; success when there was no chargeable work to enqueue.

Available options:
accepted,
success
Allowed value: "accepted"
task_id
string
required

TaskCenter identifier. Present when status is accepted.

Pattern: ^[0-9]+$
Example:

"321"

job_id
string
required

Alias of task_id. Present when status is accepted.

Pattern: ^[0-9]+$
Example:

"321"

skipped_personnel_ids
string[]

Submitted personnel identifiers that did not create chargeable work.

skipped_detail
object

Reasons submitted personnel records were skipped, grouped by condition.