Skip to main content
Retrieve the execution history and logs for a specific cron job. This endpoint provides detailed information about past executions, including success/failure status, response codes, and error messages.

Path Parameters

string
required
Your A1Base account ID
string
required
The unique identifier of the cron job (UUID format)

Query Parameters

integer
default:"1"
Page number for pagination (minimum: 1)
integer
default:"50"
Number of items per page (minimum: 1, maximum: 100)
string
Filter by execution status: success, failure, error, timeout
string
Filter logs after this date (ISO 8601 format)Example: 2024-01-01T00:00:00Z
string
Filter logs before this date (ISO 8601 format)Example: 2024-01-31T23:59:59Z

Response

array
Array of execution log objects
object
Pagination information

Log Analysis Examples

Shows the 10 most recent failed executions.
Get all executions for a specific day to calculate success rate.
Find all executions that timed out to identify performance issues.
Analyze error patterns to improve reliability.

Understanding Status Codes

The endpoint returned a 2xx status code
The endpoint returned a 4xx or 5xx status code
Network error or invalid endpoint URL
The request exceeded the configured timeout

Best Practices

  1. Regular Monitoring: Check logs daily for critical jobs
  2. Set Up Alerts: Use failure callbacks to get notified immediately
  3. Analyze Patterns: Look for time-based failure patterns
  4. Export Important Logs: Download logs before they expire
  5. Calculate Metrics: Track success rates and response times

Log Retention

Execution logs are retained for 30 days. Export important logs if you need longer retention.