Query compliance audit trail

const url = 'https://saperly.com/api/v1/compliance/audit?line_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&phone_number=%2B14155552671&event_type=call_started&from=2024-01-01T00%3A00%3A00Z&to=2024-01-31T23%3A59%3A59Z&limit=25&offset=0';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "events": [
    {
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "line_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "call_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "phone_number": "+14155552671",
      "event_type": "disclosure_played",
      "metadata": {
        "disclosure_version": "v2.1",
        "played_duration_seconds": 30
      },
      "created_at": "2024-01-15T09:30:00Z"
    }
  ],
  "total": 1
}

Returns an immutable audit trail of compliance events. Supports filtering by line, phone number, event type, and date range.

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Query parameters

line_idstringOptionalformat: "uuid"

Filter by line ID

phone_numberstringOptional

Filter by E.164 phone number

event_typeenumOptional

Filter by event type

fromdatetimeOptional

Start of date range (ISO 8601)

todatetimeOptional

End of date range (ISO 8601)

limitintegerOptional1-100Defaults to 50

Maximum number of results (1-100)

offsetintegerOptional>=0Defaults to 0

Number of results to skip

Response

List of compliance events

eventslist of objects

totalinteger

Total number of matching events

Errors

401

Unauthorized Error