## Start a line reputation audit

`phone_numbers.start_reputation_audit(strphone_number)  -> ReputationAuditStarted`

**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).

### Parameters

- `phone_number: str`

### Returns

- `class ReputationAuditStarted: …`

  - `audit_id: str`

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

  - `status: Literal["pending", "complete", "error"]`

    A newly started audit is `pending`.

    - `"pending"`

    - `"complete"`

    - `"error"`

### Example

```python
import os
from linq import LinqAPIV3

client = LinqAPIV3(
    api_key=os.environ.get("LINQ_API_V3_API_KEY"),  # This is the default and can be omitted
)
reputation_audit_started = client.phone_numbers.start_reputation_audit(
    "phoneNumber",
)
print(reputation_audit_started.audit_id)
```

#### Response

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