---
title: "Retrieve executions for the current authenticated user."
method: GET
path: "/api/v1/execution/user"
---

# Retrieve executions for the current authenticated user.

`GET /api/v1/execution/user`

**Authentication**: JWT token required
**Access**: Returns only executions belonging to the current user
**Scope**: User-specific endpoint - users can only see their own executions

**Query Parameters**:
- `include`: Comma-separated list of additional fields to include in response
- `exclude`: Comma-separated list of fields to exclude from response
- `filter`: Search/filter executions by script name, status, or other attributes
- `sort`: Sort field (prefix with '-' for descending, e.g., '-created_at',
  '-updated_at')
- `updated_at`: Filter executions started after specific timestamp (ISO 8601)
- `page`: Page number for pagination (triggers pagination when provided)
- `per_page`: Items per page (1-100, default: 20)

**Response Schema (without pagination)**:
```json
{
  "data": [
    {
      "id": "exec-123",
      "script_id": "script-456",
      "status": "SUCCESS",
      "params": {
        "region": "africa",
        "year_start": 2020,
        "year_end": 2023
      },
      "user_id": "user-789",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T11:45:00Z",
      "start_time": "2025-01-15T10:31:00Z",
      "end_time": "2025-01-15T11:45:00Z",
      "results": {
        "output_file": "analysis_results.json",
        "summary": "Processing completed successfully"
      }
    }
  ]
}
```

**Response Schema (with pagination)**:
```json
{
  "data": [...],
  "page": 1,
  "per_page": 20,
  "total": 45
}
```

**Execution Status Values**:
- `PENDING`: Execution queued, waiting to start
- `RUNNING`: Currently executing
- `SUCCESS`: Completed successfully with results
- `FAILED`: Execution failed with error
- `CANCELLED`: Execution was cancelled before completion

**Filtering Examples**:
- `?filter=land-analysis` - Find executions related to "land-analysis" script
- `?filter=status:SUCCESS` - Find only successful executions
- `?filter=2024` - Find executions from 2024 (searches in timestamps)

**Sorting Examples**:
- `?sort=created_at` - Sort by creation time ascending
- `?sort=-updated_at` - Sort by last update descending (most recent first)
- `?sort=status` - Sort by execution status

**Timestamp Filtering**:
- `?updated_at=2025-01-15T10:30:00Z` - Find executions started after date
- `updated_at` parameter accepts ISO 8601 format
- Returns executions that started after the specified timestamp
- Useful for incremental synchronization and monitoring recent activity

**Pagination Examples**:
- `?page=1&per_page=50` - Get first 50 executions with pagination
- `?page=2&per_page=20` - Get second page with 20 executions per page
- **Performance Note**: Without pagination, results are limited to 1000 executions

**Field Control Examples**:
- `?include=script,logs` - Include script details and execution logs
- `?include=script_name,user_name` - Include script and user names
- `?exclude=params,results` - Exclude verbose parameter and result data

**Combined Query Examples**:
    - `?updated_at=2025-08-01&include=script&page=1&per_page=20`
- `?filter=vegetation&sort=-created_at&exclude=params`

**Error Responses**:
- `401 Unauthorized`: JWT token required
- `500 Internal Server Error`: Failed to retrieve executions

## Response `200`

Success

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/trends/apis/trends-earth-api.md) · [All operations](https://skmtc.dev/trends/apis/trends-earth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trends/trends-earth-api/revisions/6bdbc0b84666/schema)