Documentation menu
List search logs
Contract for GET /api/search-logs.
GET
/api/search-logsTenant admins can list search audit records from their own institution. Response snapshots are excluded from list rows.
Authentication
This endpoint requires a tenant admin Bearer JWT.
Parameters
| Field | In | Type | Description |
|---|---|---|---|
page | query | integer | One-based page number. |
pageSize | query | integer | Results per page, capped by the API key policy. |
dateFrom | query | string | Start date filter in ISO date format. |
dateTo | query | string | End date filter in ISO date format. |
searchType | query | string | Filter API key searches or tenant JWT searches. |
success | query | string | Filter successful or failed records. |
hasMatch | query | string | Filter records by whether the search returned a match. |
apiKeyId | query | string | Filter by API key id. |
userId | query | string | Filter by user id. |
q | query | string | Free-text search across query, actor and top matched entity fields. |
source | query | string | Filter by requested or matched canonical source. |
Responses
| HTTP | Description | Schema |
|---|---|---|
200 | Successful response | PaginatedSearchLogs |
400 | Invalid or missing request data | ErrorResponse |
401 | Authentication is missing or invalid | ErrorResponse |
403 | Account, permission, source scope, domain or IP restriction failed | ErrorResponse |
404 | Record not found | ErrorResponse |
500 | Server error | ErrorResponse |
Decision boundary
An API result is a candidate match. A final sanctions or compliance decision requires official-source verification and human review.