# Retrieve an export entry

`GET https://api.lingohub.com/v2/export-entries/{exportEntryId}`

LingoHub API V2 (Beta) · [Exports](https://developers.lingohub.com/reference/v2/operations/tags/exports.md) · operation `getExportEntry`

Returns one export entry, the same object as in listExportEntries. A succeeded entry gets a fresh `download_url`, valid for 24 hours, on every read. Requires stack-level resource view permission.

## Parameters

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `exportEntryId` | path | yes | string | Unique identifier of the export entry. |

## Example request

```sh
curl --request GET \
  --url https://api.lingohub.com/v2/export-entries/ree_0197c8f2-5a6b-7cde-8f12-3456789abcde \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Responses

- `200`: The export entry.
- `400`: 
- `401`: 
- `403`: 
- `404`: 
- `429`: 
- `500`: 
- `503`: 

## OpenAPI definition

The complete definition of this operation, with every schema it references:

````json
{
  "openapi": "3.1.0",
  "info": {
    "title": "LingoHub API V2 (Beta)",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://api.lingohub.com",
      "description": "LingoHub"
    }
  ],
  "tags": [
    {
      "name": "Exports",
      "description": "Export the files of a branch in the background and download them."
    }
  ],
  "paths": {
    "/v2/export-entries/{exportEntryId}": {
      "get": {
        "tags": [
          "Exports"
        ],
        "summary": "Retrieve an export entry",
        "description": "Returns one export entry, the same object as in listExportEntries. A succeeded entry gets a fresh `download_url`, valid for 24 hours, on every read. Requires stack-level resource view permission.",
        "operationId": "getExportEntry",
        "parameters": [
          {
            "name": "exportEntryId",
            "in": "path",
            "description": "Unique identifier of the export entry.",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Public id that is created from the type prefix of the corresponding resource and its UUID. I.e : For a resource export entry, a valid value would be : ree_0197c8f2-5a6b-7cde-8f12-3456789abcde",
              "pattern": "^ree_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
            },
            "example": "ree_0197c8f2-5a6b-7cde-8f12-3456789abcde"
          }
        ],
        "responses": {
          "200": {
            "description": "The export entry.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "RateLimit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportEntry"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "headers": {
      "ETag": {
        "description": "Opaque strong validator for this representation. Keep its quotation marks and use it as If-Match on a documented conditional write. A replay carries the original ETag, which may now be stale.",
        "schema": {
          "type": "string"
        }
      },
      "RateLimit": {
        "description": "State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with `r` = requests remaining right now and `t` = seconds until the full quota is available again. Example: `\"api-key\";r=42;t=7`. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.",
        "schema": {
          "type": "string"
        }
      },
      "RateLimit-Policy": {
        "description": "The rate-limit policies applied to the request: each quoted policy name with `q` = sustained request quota per window of `w` seconds. Example: `\"api-key\";q=180;w=60, \"workspace\";q=600;w=60`. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.",
        "schema": {
          "type": "string"
        }
      },
      "Retry-After": {
        "description": "Seconds to wait before retrying.",
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "schemas": {
      "ExportEntry": {
        "type": "object",
        "description": "One file of an export, in one language or in all of them.",
        "properties": {
          "object_type": {
            "type": "string",
            "description": "Always `EXPORT_ENTRY`.",
            "enum": [
              "EXPORT_ENTRY"
            ],
            "example": "EXPORT_ENTRY"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the export entry.",
            "example": "ree_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "minLength": 1,
            "pattern": "^ree_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "export_id": {
            "type": "string",
            "description": "Unique identifier of the export the entry belongs to.",
            "example": "reg_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "pattern": "^reg_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "file_path": {
            "type": [
              "string",
              "null"
            ],
            "description": "The file path of the export entry.",
            "example": "en.xliff"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Language of the file; null for a file that holds several languages.",
            "example": "en"
          },
          "status": {
            "$ref": "#/components/schemas/ExportEntryStatus",
            "description": "Current status of the export entry.",
            "example": "SUCCEEDED"
          },
          "status_details": {
            "description": "Machine-readable outcome explanation, including failures and explained skips; null when no explanation was recorded or is needed.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/SyncStatusDetails"
              },
              {
                "type": "null"
              }
            ],
            "example": null
          },
          "download_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL of the exported file, valid for 24 hours; reading the entry again gives a fresh one. Null unless the entry SUCCEEDED, which it can also do in a failed export.",
            "example": "https://storage.lingohub.com/export-entries/ree_0197c8f2-5a6b-7cde-8f12-3456789abcde?token=abc"
          },
          "download_url_expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When `download_url` stops working; null when there is no URL.",
            "example": "2026-01-02T10:40:00.123Z"
          },
          "resource_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unique identifier of the resource (file) this entry was exported from, to look up its current content_version. Null for entries without a single resource.",
            "example": "rc_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "pattern": "^rc_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "content_version": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Version of the translatable data of this file language when the entry was scheduled (the file's own content_version for a multi-language entry). Compare it with the resource's content_version for the same language: while they are equal, and the export settings are the same, the data behind the file is unchanged. Label assignments and removals can conservatively advance this version even for formats without labels. If inputs change while rendering, the scheduled version is retained as a lower bound. A LingoHub release can still change how a format is rendered; re-export after such a change when byte identity matters. Null for historical entries or entries without a single resource version.",
            "example": 42
          },
          "key_count": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Selected logical keys in this successful file entry; bundled languages count each key once. Null when no count was recorded. Separate language files have separate counts.",
            "example": 500,
            "minimum": 0
          },
          "file_size_bytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Generated file byte length before outer archive compression; null for historical entries or entries without a file.",
            "example": 2048,
            "minimum": 0
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the entry was created.",
            "example": "2025-01-15T10:30:00.123Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the entry was last updated.",
            "example": "2025-06-20T14:45:00.123Z"
          }
        },
        "required": [
          "content_version",
          "created_at",
          "download_url",
          "download_url_expires_at",
          "export_id",
          "file_path",
          "file_size_bytes",
          "id",
          "key_count",
          "language_code",
          "object_type",
          "resource_id",
          "status",
          "status_details",
          "updated_at"
        ]
      },
      "ExportEntryStatus": {
        "type": "string",
        "description": "Status of a single file entry within an export job.",
        "enum": [
          "QUEUED",
          "PROCESSING",
          "SUCCEEDED",
          "FAILED",
          "SKIPPED"
        ]
      },
      "SyncStatusDetails": {
        "type": "object",
        "description": "A machine-readable explanation of a background operation or entry outcome. The detail is safe display text, not a value to parse. A failed or partial operation may already have applied changes; inspect its entries before retrying.",
        "properties": {
          "code": {
            "$ref": "#/components/schemas/SyncStatusCode",
            "description": "Stable public outcome code.",
            "example": "NO_FILES"
          },
          "detail": {
            "type": "string",
            "description": "English explanation of the outcome.",
            "example": "There are no files to export."
          }
        },
        "required": [
          "code",
          "detail"
        ]
      },
      "SyncStatusCode": {
        "type": "string",
        "description": "Public background-operation and entry outcome codes. ALREADY_EXISTS explains a skipped language addition. PARTIAL_FAILURE means some work completed. UNKNOWN_ERROR means no more specific cause was recorded. Clients must tolerate future codes.",
        "enum": [
          "ALREADY_EXISTS",
          "UNKNOWN_ERROR",
          "PARTIAL_FAILURE",
          "STORAGE_UPLOAD_FAILED",
          "STORAGE_DOWNLOAD_FAILED",
          "ARCHIVE_CREATION_FAILED",
          "LANGUAGE_NOT_DETECTED",
          "FILE_PATH_NOT_DETECTED",
          "PRETRANSLATION_FAILED",
          "TRANSLATION_PROVIDER_FAILED",
          "EMPTY_FILE",
          "UNKNOWN_ENCODING",
          "UNSUPPORTED_IMPORT_FORMAT",
          "INVALID_FILE_SYNTAX",
          "DUPLICATE_KEY",
          "KEY_OPERATION_IN_PROGRESS",
          "INVALID_DOCUMENT",
          "DOCUMENT_PROCESSING_FAILED",
          "UNSUPPORTED_EXPORT_FORMAT",
          "FILE_GENERATION_FAILED",
          "INVALID_FILE_STRUCTURE",
          "RESOURCE_TREE_CHANGED",
          "RESOURCE_NOT_FOUND",
          "LANGUAGE_NOT_FOUND",
          "LANGUAGE_NOT_SUPPORTED",
          "NO_RESOURCES",
          "NO_FILES",
          "ENTRY_FAILURES",
          "DOCUMENT_VERSION_MISSING",
          "DOCUMENT_MERGE_FAILED",
          "INVALID_TRANSLATIONS",
          "INTEGRATION_RESOURCE_NOT_FOUND",
          "INTEGRATION_FAILED",
          "INCOMPLETE_TRANSLATION",
          "INTERRUPTED",
          "SELECTION_CHANGED",
          "EMPTY_SELECTION",
          "MOVE_SOURCE_CHANGED",
          "BACKUP_FAILED",
          "RESTORE_FAILED",
          "EXECUTION_FAILED",
          "TIMED_OUT"
        ]
      },
      "Error": {
        "type": "object",
        "description": "RFC 9457 problem details. `code` identifies the problem type (one per `type` URL); `errors` lists rejected fields or parameters; `required_permission` names the permission a 403 lacked.",
        "properties": {
          "type": {
            "type": "string",
            "description": "URL identifying the problem type and pointing to its documentation.",
            "example": "https://api.lingohub.com/errors/resource-not-found"
          },
          "title": {
            "type": "string",
            "description": "Short, constant summary of the problem type.",
            "example": "Resource not found"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "description": "HTTP status code.",
            "example": 404
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation of this occurrence of the problem.",
            "example": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found."
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that produced the problem.",
            "example": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde"
          },
          "code": {
            "$ref": "#/components/schemas/ErrorCode",
            "description": "Machine-readable problem type.",
            "example": "resource_not_found"
          },
          "request_id": {
            "type": "string",
            "description": "Correlation id of the request, also returned in the `X-Request-ID` header. Quote it when contacting support.",
            "example": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          },
          "errors": {
            "type": "array",
            "description": "Rejected fields or parameters. Present when the problem concerns specific fields or parameters.",
            "example": [
              {
                "detail": "must be at least 2 characters long",
                "pointer": "#/name",
                "parameter": "limit",
                "code": "minLength"
              }
            ],
            "items": {
              "$ref": "#/components/schemas/FieldError"
            }
          },
          "required_permission": {
            "$ref": "#/components/schemas/RequiredPermission",
            "description": "The permission the API key lacks. Present on 403 responses."
          }
        },
        "required": [
          "code",
          "detail",
          "instance",
          "request_id",
          "status",
          "title",
          "type"
        ]
      },
      "ErrorCode": {
        "type": "string",
        "description": "Machine-readable problem type of a V2 error response. Each code has a fixed HTTP status and documentation at its `type` URL.",
        "enum": [
          "invalid_json",
          "invalid_parameter",
          "missing_parameter",
          "unknown_parameter",
          "invalid_filter",
          "invalid_cursor",
          "bad_request",
          "missing_api_key",
          "invalid_api_key",
          "expired_api_key",
          "revoked_api_key",
          "disabled_api_key",
          "insufficient_permissions",
          "resource_not_found",
          "route_not_found",
          "method_not_allowed",
          "not_acceptable",
          "precondition_failed",
          "content_too_large",
          "unsupported_media_type",
          "already_exists",
          "idempotency_outcome_unknown",
          "idempotency_key_in_use",
          "stack_not_empty",
          "branch_not_ready",
          "backup_not_ready",
          "backup_in_use",
          "default_branch_protected",
          "owner_membership_protected",
          "source_language_protected",
          "branch_limit_reached",
          "context_image_limit_reached",
          "automation_limit_reached",
          "translation_order_pending",
          "git_integration_not_configured",
          "branch_git_integration_not_configured",
          "git_integration_unauthorized",
          "conflict",
          "validation_failed",
          "idempotency_key_mismatch",
          "rate_limit_exceeded",
          "internal_error",
          "upstream_error",
          "service_unavailable",
          "upstream_timeout"
        ]
      },
      "FieldError": {
        "type": "object",
        "description": "A rejected field or parameter. `pointer` locates a body field (RFC 6901 JSON Pointer), `parameter` a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as `filter`.",
        "properties": {
          "detail": {
            "type": "string",
            "description": "Human-readable description of the problem.",
            "example": "must be at least 2 characters long"
          },
          "pointer": {
            "type": [
              "string",
              "null"
            ],
            "description": "JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.",
            "example": "#/name"
          },
          "parameter": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the offending query, path or header parameter, or of the multipart form field.",
            "example": "limit"
          },
          "code": {
            "$ref": "#/components/schemas/FieldErrorCode",
            "description": "Why the field or parameter was rejected.",
            "example": "minLength"
          }
        },
        "required": [
          "code",
          "detail",
          "parameter",
          "pointer"
        ]
      },
      "FieldErrorCode": {
        "type": "string",
        "description": "Why a field or parameter was rejected: the JSON Schema keyword of the violated rule, or one of the documented rules that no schema can express.",
        "enum": [
          "required",
          "type",
          "enum",
          "minLength",
          "maxLength",
          "minimum",
          "maximum",
          "pattern",
          "format",
          "additionalProperties",
          "minItems",
          "maxItems",
          "uniqueItems",
          "already_exists",
          "not_found",
          "not_supported",
          "unsupported_file_extension",
          "file_too_large",
          "file_empty",
          "invalid_archive",
          "empty_archive"
        ]
      },
      "RequiredPermission": {
        "type": "object",
        "description": "The permission the API key lacks, in the vocabulary of the API key permission settings.",
        "properties": {
          "scope": {
            "$ref": "#/components/schemas/PermissionScope",
            "description": "Where the permission applies.",
            "example": "STACK"
          },
          "target": {
            "$ref": "#/components/schemas/PermissionTarget",
            "description": "The area the permission governs.",
            "example": "SETTINGS"
          },
          "level": {
            "$ref": "#/components/schemas/PermissionLevel",
            "description": "The access level required.",
            "example": "MANAGE"
          }
        },
        "required": [
          "level",
          "scope",
          "target"
        ]
      },
      "PermissionScope": {
        "type": "string",
        "description": "Where a permission applies: `WORKSPACE` permissions cover workspace-level resources, `STACK` permissions the resources of a stack (its projects, branches, resources, languages, ...).",
        "enum": [
          "WORKSPACE",
          "STACK"
        ]
      },
      "PermissionTarget": {
        "type": "string",
        "description": "The area a permission governs.",
        "enum": [
          "GENERAL",
          "BILLING_SUBSCRIPTION",
          "WORKSPACES",
          "MEMBERS",
          "PLUGINS_INTEGRATIONS",
          "LOGS",
          "API_ACCESS",
          "STACKS",
          "TRANSLATION_ORDERS",
          "WORK_REPORTS",
          "STYLE_GUIDES",
          "GLOSSARIES",
          "TRANSLATION_MEMORIES",
          "LABELS",
          "AI_TRANSLATION",
          "QUICK_TRANSLATIONS",
          "SETTINGS",
          "ACTIVITIES",
          "RESOURCES",
          "CONTEXT_IMAGES",
          "LANGUAGES",
          "SEGMENT_KEYS",
          "SEGMENTS",
          "SEGMENT_TEXTS"
        ]
      },
      "PermissionLevel": {
        "type": "string",
        "description": "Access level of a permission: `MANAGE` includes `WRITE` and `VIEW`.",
        "enum": [
          "NO_ACCESS",
          "VIEW",
          "WRITE",
          "MANAGE"
        ]
      }
    },
    "responses": {
      "BadRequest": {
        "description": "The request is malformed: an unknown or invalid query parameter, an invalid id in the path, or a body that is not valid JSON. `code` names the problem, `errors` the parameter or field.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Invalid or missing API key.",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Insufficient permissions.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "NotFound": {
        "description": "The resource does not exist, or the API key cannot see it.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "InternalServerError": {
        "description": "An unexpected internal server error occurred.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "description": "API key authentication. Create API keys in your LingoHub workspace settings. Keys use the `lh-api_` prefix. Pass the full key as the Bearer token.",
        "scheme": "bearer"
      }
    }
  }
}
````
