> ## Documentation Index > Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get inbound email logs > Retrieves logs of inbound email activity with filtering options. Either uuid (for domain) or subdomain_id parameter is required. ## OpenAPI ````yaml /openapi.json get /inbound/logs openapi: 3.0.0 info: title: JetEmail API version: 1.0.0 description: API documentation for JetEmail's transactional email service. servers: - url: https://api.jetemail.com description: Production security: - apiKeyAuth: [] externalDocs: description: Download OpenAPI Specification url: /openapi.json paths: /inbound/logs: get: tags: - Inbound summary: Get inbound email logs description: >- Retrieves logs of inbound email activity with filtering options. Either uuid (for domain) or subdomain_id parameter is required. parameters: - name: uuid in: query description: >- UUID of the inbound domain to fetch logs for. Either uuid or subdomain_id is required. schema: type: string pattern: >- ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ - name: subdomain_id in: query description: >- ID of the subdomain to fetch logs for. Either uuid or subdomain_id is required. schema: type: integer minimum: 1 - name: limit in: query description: Number of records to return (1-1000) schema: type: integer minimum: 1 maximum: 1000 default: 100 - name: page in: query description: Page number for pagination schema: type: integer minimum: 1 default: 1 - name: offset in: query description: Number of records to skip (alternative to page) schema: type: integer minimum: 0 default: 0 - name: uid in: query description: Filter by unique identifier schema: type: string pattern: ^[A-Za-z0-9-_]{1,100}$ - name: logtype in: query description: Filter by log type schema: type: string enum: - spam - delivery - inbound - outbound - name: subject in: query description: Filter by email subject schema: type: string maxLength: 500 - name: from in: query description: Filter by sender email schema: type: string format: email - name: to in: query description: Filter by recipient email schema: type: string format: email - name: spamscore_min in: query description: Filter by minimum spam score schema: type: number minimum: 0 - name: spamscore_max in: query description: Filter by maximum spam score schema: type: number minimum: 0 - name: host in: query description: Filter by host schema: type: string maxLength: 100 - name: ip in: query description: Filter by IP address schema: type: string pattern: >- ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ - name: date_from in: query description: Filter by start date (Unix timestamp) schema: type: integer minimum: 0 - name: date_to in: query description: Filter by end date (Unix timestamp) schema: type: integer minimum: 0 - name: sort_by in: query description: Field to sort by schema: type: string default: date maxLength: 50 - name: sort_order in: query description: Sort order schema: type: string enum: - ASC - DESC default: DESC responses: '200': description: Successfully retrieved logs content: application/json: schema: type: object properties: success: type: boolean example: true data: type: array description: >- Consolidated log entries. Each entry represents a single inbound email (keyed by uid) with aggregated delivery/rejection counts and an actions array containing the individual underlying log rows. items: type: object properties: uid: type: string description: Unique identifier for the email example: 67020a88e9ab3a023e12 status: type: string description: >- Overall status of the email across all actions (e.g. delivered, rejected, pending) example: delivered from: type: string description: Sender email address example: sender@example.com to: type: string description: Recipient email address example: recipient@example.com subject: type: string description: Email subject example: 'Re: Online afspraken' rejected_count: type: integer description: >- Number of rejected delivery attempts aggregated into this entry example: 12 delivery_count: type: integer description: >- Number of successful delivery attempts aggregated into this entry example: 1 delivered_timestamp: type: integer format: int64 description: >- Millisecond Unix timestamp of the successful delivery. 0 or null if never delivered. example: 1776972847891 rejected_response: type: string description: >- Representative SMTP response for the most recent rejection, if any example: 'RCPT TO failed for info@example.com: 450 4.1.8 ...' response: type: string description: >- Representative SMTP response for the successful delivery, if any example: '250 2.0.0 Ok: queued as 638B63A5AD5' actions: type: array description: >- Individual log actions that make up this consolidated entry, in chronological order. Each item is a single underlying log row (inbound receipt, rejection, delivery attempt, spam evaluation, etc.). items: type: object properties: id: type: string description: Unique identifier for this action row example: bc1ca372-0000-0000-0000-000000000000 logtype: type: string description: >- Type of action. Known values include: inbound, delivery, REJECTED, spam, outbound. example: inbound response: type: string description: SMTP or processing response for this action example: '250 2.0.0 Ok: queued as 638B63A5AD5' date: type: integer format: int64 description: Millisecond Unix timestamp of the action example: 1776933973950 timestamp: type: string format: date-time description: ISO-8601 timestamp of the action example: '2026-04-23T08:46:13.950Z' host: type: string description: Host involved in the action example: '' ip: type: string description: IP address associated with the action example: '' port: type: integer description: Port number used example: 0 mode: type: string description: Connection mode (smtp, http, https) example: '' delay: type: number description: Delay in seconds before this action example: 0 spam_score: type: number description: Spam score evaluated for this action example: 0 spam_report: type: string description: Spam report text for this action example: '' count: type: integer description: Number of entries returned in this response example: 1 '400': description: Bad Request - Invalid parameters content: application/json: schema: type: object properties: error: type: string example: Invalid parameter format '401': description: Unauthorized - User not authenticated content: application/json: schema: type: object properties: success: type: boolean example: false error: type: string example: Required information not found '404': description: Not Found - No results found content: application/json: schema: type: object properties: success: type: boolean example: false error: type: string example: No results found '500': description: Server error content: application/json: schema: type: object properties: error: type: string example: Failed to fetch logs components: securitySchemes: apiKeyAuth: type: http scheme: bearer description: API key for account management endpoints. Use your api_ prefixed token. ````