## Start a line reputation audit

**post** `/v3/phone_numbers/{phoneNumber}/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.

### Path Parameters

- `phoneNumber: string`

### Returns

- `ReputationAuditStarted object { audit_id, status }`

  - `audit_id: string`

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

  - `status: "pending" or "complete" or "error"`

    A newly started audit is `pending`.

    - `"pending"`

    - `"complete"`

    - `"error"`

### Example

```http
curl https://api.linqapp.com/api/partner/v3/phone_numbers/$PHONE_NUMBER/reputation_audit \
    -X POST \
    -H "Authorization: Bearer $LINQ_API_V3_API_KEY"
```

#### Response

```json
{
  "audit_id": "audit_id",
  "status": "pending"
}
```