Get i18n Job Status

Retrieve the current status and details of an i18n translation job.

Endpoint

GET /v2/translate/i18n/jobs/{job_id}/status

Description

Retrieve the current status and details of an i18n translation job. Use this endpoint to check if your translation job has completed and to get information about translated files.

Headers

X-API-KEY string (required) : Your API key for authentication

Path Parameters

job_id string (UUID, required) : The unique identifier of the translation job

Example Request

curl -X GET "https://v2-api.translateplus.io/v2/translate/i18n/jobs/550e8400-e29b-41d4-a716-446655440000/status" \
  -H "X-API-KEY: your_api_key"

Success Response (200 OK)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "original_filename": "translations.json",
  "file_type": "json",
  "source_language": "en",
  "target_languages": ["fr", "es", "de"],
  "total_keys": 150,
  "translated_keys": 150,
  "failed_keys": 0,
  "error_message": null,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:32:15Z",
  "completed_at": "2025-01-15T10:32:15Z",
  "translated_files": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "language_code": "fr",
      "file_url": "https://v2-api.translateplus.io/v2/translate/i18n/jobs/550e8400-e29b-41d4-a716-446655440000/download/?language_code=fr",
      "file_size": 15234,
      "created_at": "2025-01-15T10:32:10Z"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440002",
      "language_code": "es",
      "file_url": "https://v2-api.translateplus.io/v2/translate/i18n/jobs/550e8400-e29b-41d4-a716-446655440000/download/?language_code=es",
      "file_size": 15189,
      "created_at": "2025-01-15T10:32:12Z"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string (UUID)	Job unique identifier
`job_id`	string (UUID)	Job unique identifier (same as id)
`status`	string	Current job status: "pending", "processing", "completed", "partial", or "failed"
`original_filename`	string	Name of the uploaded file
`file_type`	string	File format: "json", "yaml", "po", "properties", "strings", or "xml"
`source_language`	string	Source language code
`target_languages`	array[string]	List of target language codes
`total_keys`	integer	Total number of translatable keys in the file
`translated_keys`	integer	Number of successfully translated keys
`failed_keys`	integer	Number of keys that failed to translate
`error_message`	string \| null	Error message if the job failed
`created_at`	string (ISO 8601)	Timestamp when the job was created
`updated_at`	string (ISO 8601)	Timestamp when the job was last updated
`completed_at`	string (ISO 8601) \| null	Timestamp when the job was completed, or null if still processing
`translated_files`	array	List of translated files available for download
`translated_files[].id`	string (UUID)	Unique identifier for the translated file
`translated_files[].language_code`	string	Target language code
`translated_files[].file_url`	string	URL to download the translated file via API endpoint (requires authentication)
`translated_files[].file_size`	integer	Size of the translated file in bytes
`translated_files[].created_at`	string (ISO 8601)	Timestamp when the file was created

Job Status Values

Status	Description
`pending`	Job is queued and waiting to be processed
`processing`	Job is currently being processed
`completed`	Job completed successfully with all translations
`partial`	Job completed but some translations failed
`failed`	Job failed to process

Error Responses

404 Not Found

Job not found:

{
  "detail": "Job not found."
}

401 Unauthorized / 403 Forbidden

Invalid or missing API key:

{
  "detail": "Invalid API key. Please verify your API key is valid."
}

Create i18n Job Download File