Phone Numbers

Start a line reputation audit

Starts an asynchronous reputation audit for a line and returns an audit_id. Poll the GET endpoint for the result.

Rate limited per line: only one audit may run at a time. Starting one while another is still running returns 202 with the running audit's audit_id rather than an error, so a retried start picks that audit back up instead of losing it — poll the id you were given.

Once an audit finishes, a new one can't be started for the same line until a cooldown elapses (429, with Retry-After carrying the wait). Keep the audit_id from the original 202: it stays readable on the GET endpoint for 24 hours, and the cooldown response does not repeat it.

post/v3/phone_numbers/{phoneNumber}/reputation_audit

Request

  • Base URL: https://api.linqapp.com/api/partner
  • URL: https://api.linqapp.com/api/partner/v3/phone_numbers/{phoneNumber}/reputation_audit
  • Auth: HTTP bearer

Path parameters

phoneNumberstring required

The line in E.164 format.

Response

Audit started, or an audit for this line was already running and its audit_id is returned so you can poll it.

audit_idstring required

Identifier for this audit. Poll GET /v3/phone_numbers/{phoneNumber}/reputation_audit/{auditId} until status is complete or error.

status'pending' | 'complete' | 'error' required

A newly started audit is pending.

Changes

No recorded changes to this operation across all 1 revision of this API.