## 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 (a second
request returns `409` while the first is still in progress), and a new
audit can't be started for the same line until a cooldown elapses
(`429`, with `Retry-After` carrying the wait).

### 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"
}
```