> ## Documentation Index > Fetch the complete documentation index at: https://docs.context.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Request Logs > List your organization's API requests, newest first. Defaults to the last 24 hours. 0 Credits Pass an entry's `request_id` to [Retrieve a Request Log](/api-reference/logs/retrieve) for the full request input and response body. Log endpoints do not consume credits and use a separate rate limit from the rest of the API. ## OpenAPI ````yaml GET /logs openapi: 3.1.0 info: title: Context.dev API description: API for retrieving context data from any website version: 1.0.0 servers: - url: https://api.context.dev/v1 security: [] tags: - name: Webhooks description: Inspect and retry webhook deliveries. These endpoints cost no credits. - name: Logs description: >- Read your organization's API request logs to debug failed calls. These endpoints cost no credits and use a separate rate limit. - name: Batch description: Scrape many pages or crawl a site asynchronously. - name: Monitors description: >- Monitor pages, sitemaps, and extracted website data for exact or semantic changes. Webhook payloads are documented by the MonitorsChangeDetectedWebhookPayload and MonitorsRunCompletedWebhookPayload schemas. - name: News description: >- Search live first-party RSS and free historical news data by company identity. paths: /logs: get: tags: - Logs summary: List request logs description: >- List your organization's API requests, newest first. Defaults to the last 24 hours. operationId: listLogs parameters: - schema: type: string format: date-time description: >- Only include requests at or after this ISO 8601 timestamp. Defaults to 24 hours before `to`. example: '2026-09-10T00:00:00Z' required: false description: >- Only include requests at or after this ISO 8601 timestamp. Defaults to 24 hours before `to`. name: from in: query - schema: type: string format: date-time description: >- Only include requests at or before this ISO 8601 timestamp. Defaults to now. example: '2026-09-11T00:00:00Z' required: false description: >- Only include requests at or before this ISO 8601 timestamp. Defaults to now. name: to in: query - schema: type: string minLength: 1 maxLength: 200 pattern: ^\/ description: Filter by endpoint path, with or without the /v1 prefix. example: /brand/retrieve required: false description: Filter by endpoint path, with or without the /v1 prefix. name: path in: query - schema: type: string minLength: 1 maxLength: 200 description: Filter by the API key that made the request. required: false description: Filter by the API key that made the request. name: key_id in: query - schema: type: integer minimum: 100 maximum: 599 description: Filter by exact HTTP status code. example: 500 required: false description: Filter by exact HTTP status code. name: status_code in: query - schema: type: string pattern: ^[A-Z][A-Z0-9_]{1,63}$ description: Filter by the `error_code` returned in the response. example: WEBSITE_ACCESS_ERROR required: false description: Filter by the `error_code` returned in the response. name: error_code in: query - schema: type: boolean default: false description: Only include requests that returned a 4xx or 5xx status. required: false description: Only include requests that returned a 4xx or 5xx status. name: errors_only in: query - schema: type: string description: >- Comma-separated request tags. Matches requests carrying any of them. Up to 20 tags, each 1-50 characters. example: nightly-import,team-alpha required: false description: >- Comma-separated request tags. Matches requests carrying any of them. Up to 20 tags, each 1-50 characters. name: tags in: query - schema: type: string minLength: 1 maxLength: 200 description: >- Case-insensitive substring match against the request query and body, e.g. a domain. example: acme.com required: false description: >- Case-insensitive substring match against the request query and body, e.g. a domain. name: search in: query - schema: type: integer minimum: 1 maximum: 1000 default: 1 description: Page number, starting at 1. required: false description: Page number, starting at 1. name: page in: query - schema: type: integer minimum: 1 maximum: 100 default: 50 description: Number of log entries per page. required: false description: Number of log entries per page. name: limit in: query responses: '200': description: A page of log entries headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ListLogsResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': description: Rate limit exceeded (60 requests per minute per organization). headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Log storage is temporarily unavailable. headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: headers: RequestId: description: >- Unique id of this API call, sent on every response and mirrored as request_id in JSON bodies. Quote it when contacting support. schema: type: string format: uuid RateLimitLimit: description: Maximum requests per minute. schema: type: integer minimum: 1 RateLimitRemaining: description: Requests remaining in the current minute. schema: type: integer minimum: 0 RateLimitReset: description: Unix timestamp in seconds when the rate limit resets. schema: type: integer schemas: ListLogsResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/LogEntry' description: Log entries, newest first. page: type: integer description: Current page number. limit: type: integer description: Entries per page. has_more: type: boolean description: Whether a next page exists. key_metadata: $ref: '#/components/schemas/KeyMetadata' request_id: $ref: '#/components/schemas/RequestId' required: - data - page - limit - has_more - request_id ErrorResponse: type: object properties: message: type: string description: Error message error_code: type: string enum: - INTERNAL_ERROR - VALID - NOT_FOUND - FORBIDDEN - USAGE_EXCEEDED - RATE_LIMITED - UNAUTHORIZED - DISABLED - PAID_PLAN_REQUIRED - INSUFFICIENT_PERMISSIONS - TIMEOUT_EXCEEDS_MAXIMUM - TIMEOUT_TOO_SHORT_FOR_WAIT - WEBSITE_ACCESS_ERROR - WEBSITE_BLOCKED - WEBSITE_NOT_FOUND - PDF_SKIPPED - PDF_IMAGES_ONLY - EXTERNAL_PROVIDER_ERROR - INPUT_VALIDATION_ERROR - ZDR_NOT_SUPPORTED - ZDR_NOT_ENABLED - FREE_EMAIL_DETECTED - DISPOSABLE_EMAIL_DETECTED - REQUEST_TIMEOUT - COLD_DOMAIN_TIMEOUT_TOO_LOW - UNSUPPORTED_CONTENT - CONTENT_TOO_LARGE - MONITOR_PAUSED - MONITOR_NO_WEBHOOK - COLLECTION_PAUSED - MONITOR_LIMIT_EXCEEDED - SEARCH_UNAVAILABLE - BATCH_LIMIT_EXCEEDED - BATCH_NOT_CANCELLABLE - BATCH_NOT_COMPLETED - IDEMPOTENCY_KEY_CONFLICT - DELIVERY_IN_PROGRESS - DELIVERY_ALREADY_DELIVERED - DELIVERY_EXPIRED - DELIVERY_CANCELLED description: Error code indicating the type of error key_metadata: $ref: '#/components/schemas/KeyMetadata' request_id: $ref: '#/components/schemas/RequestId' required: - request_id LogEntry: type: object properties: request_id: type: string description: Request ID of the logged API call. timestamp: type: string format: date-time description: When the request completed. method: type: string description: HTTP method. example: GET path: type: string description: Endpoint path as called. example: /v1/brand/retrieve status_code: type: integer description: HTTP status code returned. example: 500 error_code: type: - string - 'null' description: The `error_code` from the response, or null on success. example: WEBSITE_ACCESS_ERROR latency_ms: type: number description: Server-side processing time in milliseconds. credits_used: type: integer description: Credits charged for this request. key_id: type: - string - 'null' description: ID of the API key that made the request. tags: type: array items: type: string description: Request tags supplied by the caller. zdr: type: boolean description: Whether the request was made under zero data retention. required: - request_id - timestamp - method - path - status_code - error_code - latency_ms - credits_used - key_id - tags - zdr KeyMetadata: type: object properties: credits_consumed: type: integer description: Credits used by this request. credits_remaining: type: integer description: Credits remaining for your organization. required: - credits_consumed - credits_remaining description: Credit usage, included whenever a valid API key is provided. RequestId: type: string format: uuid description: >- Unique id of this API call, also sent in the X-Request-Id response header. Quote it when contacting support about a failed request. example: 3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91 responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Unauthorized: description: Unauthorized headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ````