Executions

Executions represent the running instances of your jobs. Use these endpoints to track execution history, view statistics, and monitor the status of your translation and processing tasks.

The execution log model

The execution log model contains detailed information about a single execution.

Properties

Name
execution_id
Type
string
Description
Unique identifier for the execution.
Name
execution_type
Type
string
Description
The type of execution (e.g., "translation", "post-editing", "quality-estimation").
Name
source_language
Type
string
Description
The source language code.
Name
target_language
Type
string
Description
The target language code.
Name
domain
Type
string
Description
The content domain for the execution.
Name
source_text
Type
string
Description
The original source text.
Name
translated_text
Type
string
Description
The resulting translated text.
Name
word_count
Type
integer
Description
Number of words processed.
Name
provider
Type
string
Description
The AI provider used (e.g., "openai", "anthropic").
Name
processing_mode
Type
string
Description
The processing mode used (e.g., "segment", "document").
Name
execution_time_ms
Type
integer
Description
Execution duration in milliseconds.
Name
executed_at
Type
timestamp
Description
Timestamp of when the execution occurred.
Name
workflow_id
Type
string
Description
The workflow ID if this execution was part of a workflow (null if standalone).

The execution history response model

The execution history response model contains a paginated list of executions.

Properties

Name
executions
Type
array
Description
Array of execution log objects.
Name
total
Type
integer
Description
Total number of executions matching the query.
Name
limit
Type
integer
Description
Maximum number of executions returned per page.
Name
offset
Type
integer
Description
Number of executions skipped.

GET/executions/history

Get execution history

This endpoint allows you to retrieve your execution history with pagination and filtering options.

Optional attributes

Name
limit
Type
integer
Description
Maximum number of executions to return (default: 50).
Name
offset
Type
integer
Description
Number of executions to skip for pagination (default: 0).
Name
execution_type
Type
string
Description
Filter by execution type (e.g., "translation", "post-editing").
Name
X-Org-Id
Type
string
Description
Organization identifier (header). If not provided, uses your default organization.

Request

GET

/v1/executions/history

curl -G https://api.elanlanguages.ai/v1/executions/history \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -d limit=10 \
  -d offset=0

Response

{
  "executions": [
    {
      "execution_id": "exec_123abc",
      "execution_type": "translation",
      "source_language": "en",
      "target_language": "es",
      "domain": "technical",
      "source_text": "Hello world",
      "translated_text": "Hola mundo",
      "word_count": 2,
      "provider": "openai",
      "processing_mode": "segment",
      "execution_time_ms": 1250,
      "executed_at": "2025-12-21T10:00:00Z",
      "workflow_id": null
    }
  ],
  "total": 145,
  "limit": 10,
  "offset": 0
}

GET/v1/executions/stats

Get execution statistics

This endpoint allows you to retrieve aggregated statistics about your executions.

Optional attributes

Name
X-Org-Id
Type
string
Description
Organization identifier (header). If not provided, uses your default organization.

Request

GET

/v1/executions/stats

curl https://api.elanlanguages.ai/v1/executions/stats \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}"

Response

{
  "total_executions": 145,
  "total_words_processed": 234500,
  "executions_by_type": {
    "translation": 89,
    "post-editing": 34,
    "quality-estimation": 22
  },
  "executions_by_status": {
    "completed": 140,
    "failed": 3,
    "pending": 2
  },
  "period_start": "2025-12-01T00:00:00Z",
  "period_end": "2025-12-21T10:30:00Z"
}

GET/v1/executions/:execution_id

Get execution details

This endpoint allows you to retrieve detailed information about a specific execution.

Required attributes

Name
execution_id
Type
string
Description
The unique identifier for the execution (path parameter).

Optional attributes

Name
X-Org-Id
Type
string
Description
Organization identifier (header). If not provided, uses your default organization.

Request

GET

/v1/executions/exec_123abc

curl https://api.elanlanguages.ai/v1/executions/exec_123abc \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}"

Response

{
  "execution_id": "exec_123abc",
  "execution_type": "translation",
  "source_language": "en",
  "target_language": "es",
  "domain": "technical",
  "source_text": "Hello world",
  "translated_text": "Hola mundo",
  "word_count": 2,
  "provider": "openai",
  "processing_mode": "segment",
  "execution_time_ms": 1250,
  "executed_at": "2025-12-21T10:00:00Z",
  "workflow_id": null
}