---
updatedAt: 2026-05-22T15:57:54.000Z
agentTools:
  projectIndex: https://docs.ometria.com/llms.txt
---

# Get translation request details.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.1.0",
    "title": "Ometria data API",
    "description": "Welcome to the Ometria API reference.\n\n\nThe Ometria API is organized around the [REST](https://en.wikipedia.org/wiki/Representational_state_transfer) methodology, and it uses resource-oriented URLs, and common HTTP response codes to indicate API errors. All requests are authenticated using an API key which can be obtained from your account settings.\n\n### HTTPS\n\nAll requests to the Ometria API MUST be carried out via HTTPS. API servers do not listen on unsecured HTTP ports to avoid the possibility of insecure information exchange.\n\n### Message encoding\n\nThe V2 Ometria API uses JSON encoding for all data exchanges and assumes UTF-8 character encoding throughout.\n\n### Rate limits\n\nThe Ometria API has a default rate limit of 4 requests per second per Ometria account. The /push/ endpoint allows 8 requests per second per Ometria account. If you expect to exceed this limit, please contact us.\n\nIn the case of your application being rate limited, the HTTP code 429 (too many requests) will be returned. In this case your application should reduce the number of requests it is trying to send.",
    "contact": {
      "name": "Ometria",
      "email": "support@ometria.com",
      "url": "https://ometria.com"
    }
  },
  "x-explorer-enabled": false,
  "paths": {
    "/translations/requests/{request_id}": {
      "get": {
        "tags": [
          "Translation Requests"
        ],
        "summary": "Get translation request details.",
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "required": true,
            "description": "The id of the translation request.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "security": [
          {
            "apiKeyReadTranslations": []
          }
        ],
        "responses": {
          "200": {
            "description": "Translation request details.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranslationRequestDetails"
                }
              }
            }
          },
          "403": {
            "description": "API key is not authorised to access this resource."
          },
          "404": {
            "description": "Translation request not found."
          },
          "500": {
            "description": "An error occurred."
          }
        }
      }
    }
  },
  "security": [
    {
      "apikey": []
    }
  ],
  "servers": [
    {
      "url": "https://api.ometria.com/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "apikey": {
        "type": "apiKey",
        "name": "X-Ometria-Auth",
        "in": "header",
        "description": "Ometria API key which can be obtained from your Ometria account administrator"
      },
      "apiKeyReadTranslations": {
        "type": "apiKey",
        "name": "X-Ometria-Auth",
        "in": "header",
        "description": "Ometria API key which can be obtained from your Ometria account administrator. **Note**: The API key must have the scope `read:translations`."
      }
    },
    "schemas": {
      "TranslationRequestDetails": {
        "properties": {
          "source_lang": {
            "type": "string",
            "title": "Source Language",
            "description": "The language code of the translation source language."
          },
          "target_lang": {
            "type": "string",
            "title": "Target Language",
            "description": "The language code of the translation target language."
          },
          "source_translations": {
            "type": "object",
            "title": "Source Translations",
            "description": "The source language translations."
          },
          "target_translations": {
            "type": "object",
            "title": "Target Translations",
            "description": "The target language translations."
          },
          "translation_tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "Translation Tags",
            "description": "The tags that are requested for translation from source to target language."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created Timestamp",
            "description": "The date and time the translation request was created."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated Timestamp",
            "description": "The date and time the translation request was last updated."
          },
          "status": {
            "type": "string",
            "title": "Status",
            "description": "The current status of the translation request.",
            "enum": [
              "pending",
              "cancelled",
              "completed"
            ]
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "source_lang",
          "target_lang",
          "source_translations",
          "target_translations",
          "translation_tags",
          "created_at",
          "updated_at",
          "status"
        ],
        "title": "TranslationRequestDetails"
      }
    }
  },
  "x-readme": {
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
```