> ## Documentation Index > Fetch the complete documentation index at: https://docs.kordless.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search request logs > Metadata-only request history for API-key and anonymous public-quote traffic — no payloads, factor values, or secrets are ever logged. Keyset pagination, 50 rows per page. Requires the `logs:read` permission. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/request-logs openapi: 3.1.0 info: title: Kordless API version: 1.0.0 description: | The Kordless API creates deterministic quotes against published Book Versions and returns immutable Quote Receipts. The same pipeline serves headless API-key traffic, Business-member sessions, and anonymous end-customer surfaces. ## Authentication Headless routes require a secret API key as a bearer token: ``` Authorization: Bearer sk_test_... ``` Test keys use the `sk_test_` prefix; Live keys use `sk_live_`. The key binds a Workspace, Project, and one Environment — a Test key can never address Live data. Member routes under `/v1/businesses/{businessId}` authenticate the caller's session and Business membership. The `/v1/public_quotes` routes are anonymous by design. ## Idempotency Quote creation accepts an optional `idempotencyKey` in the request body. Retrying with the same key and the same payload replays the original Quote; the same key with a different payload returns `409 idempotency_conflict`. When omitted, the server generates an `auto_` key. ## Envelopes and request IDs Success responses are `{ "data": …, "requestId": … }`; failures are `{ "error": { "code", "message", "requestId", "details?" } }`. Every response also carries an `x-request-id` header, echoed on created Quotes as `requestCorrelationId`. servers: - url: https://your-kordless-instance.com description: Replace with your Kordless instance base URL security: - BearerAuth: [] tags: - name: Quotes description: Headless quote creation and retrieval with an API key. - name: Public quotes description: Anonymous end-customer quotes against the Live-published Book. - name: Business portal description: Member-session routes used by the hosted Business Portal. - name: API keys description: >- Workspace-session routes for the API-key lifecycle (create, rotate, revoke). - name: Webhooks description: >- Workspace-session routes for webhook endpoints, deliveries, test events, and replay. - name: Request logs description: Workspace-session log search and Quote Intent traces. - name: Status description: Anonymous liveness signal. paths: /v1/request-logs: get: tags: - Request logs summary: Search request logs description: | Metadata-only request history for API-key and anonymous public-quote traffic — no payloads, factor values, or secrets are ever logged. Keyset pagination, 50 rows per page. Requires the `logs:read` permission. operationId: searchRequestLogs parameters: - name: environmentId in: query schema: type: string format: uuid description: Restrict to one Environment. - name: statusClass in: query schema: type: integer minimum: 1 maximum: 5 description: HTTP status class (for example `4` for client errors). - name: requestId in: query schema: type: string description: One exact request ID. - name: quoteIntentId in: query schema: type: string format: uuid description: Every request touching one Quote Intent. - name: cursor in: query schema: type: string format: date-time description: The `nextCursor` value from the previous page. responses: '200': description: A page of request log rows. content: application/json: schema: $ref: '#/components/schemas/RequestLogListResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': $ref: '#/components/responses/InvalidRequest' security: [] components: schemas: RequestLogListResponse: type: object required: - data - requestId properties: data: type: array items: $ref: '#/components/schemas/ApiRequestLog' requestId: type: string nextCursor: type: string format: date-time nullable: true description: >- Pass as `cursor` for the next page; null when no further pages exist. ApiRequestLog: type: object description: >- Metadata-only request log row — never payloads, factor values, or secrets. properties: id: type: string format: uuid requestId: type: string workspaceId: type: string format: uuid projectId: type: string format: uuid nullable: true environmentId: type: string format: uuid nullable: true apiKeyId: type: string format: uuid nullable: true source: type: string enum: - api_key - hosted_public method: type: string path: type: string statusCode: type: integer errorCode: type: string nullable: true latencyMs: type: integer minimum: 0 quoteIntentId: type: string format: uuid nullable: true occurredAt: type: string format: date-time ErrorEnvelope: type: object required: - error properties: error: type: object required: - code - message - requestId properties: code: type: string message: type: string requestId: type: string details: type: object description: >- Optional structured context, for example `fields` on validation failures. responses: Unauthorized: description: No authenticated Workspace session. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: unauthorized message: Authentication is required. requestId: req_9f8e7d6c Forbidden: description: The Workspace role lacks the required permission. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: forbidden message: Your Workspace role cannot perform this action. requestId: req_9f8e7d6c InvalidRequest: description: >- The request body or query failed validation; `details.fields` lists the offending fields. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_request message: The request failed validation. requestId: req_9f8e7d6c details: fields: url: - Expected an HTTPS URL without credentials or fragments securitySchemes: BearerAuth: type: http scheme: bearer description: >- Secret API key (`sk_test_…` or `sk_live_…`). The key binds a Workspace, Project, and Environment. ````