Check the status of translations

Endpoint for checking the status of a translation request

This endpoint allows you to check the status of a translation request previously registered in the system. You can track the progress and details of each individual translation, based on the ID returned when the request was created.

Endpoint URL

 https://api.ovesio.com/v1/translate/request/status/{id}

Method

 GET

Example request (with request ID)

 https://api.ovesio.com/v1/translate/request/status/320126

URL parameters

Possible answers

Successful response (HTTP 200)

{
  "success": true,
  "data": {
    "id": 320126,
    "ref": "product-123",
    "from": "en",
    "status": "completed",
    "credits": 5,
    "callback_url": "https://example.com/api/callback",
    "created_at": "2024-08-13T13:12:41.000000Z",
    "data": [
      {
        "from": "en",
        "to": "fr",
        "status": "completed",
        "content": [
          {
            "key": "title",
            "value": "Ordinateur portable de jeu ASUS ROG"
          }
        ]
      },
      {
        "from": "en",
        "to": "de",
        "status": "completed",
        "content": [
          {
            "key": "title",
            "value": "ASUS ROG Gaming-Laptop"
          }
        ]
      }
    ]
  }
}

This response confirms the details of the request and the status of the individual translations. Each object in data provides information about the source language, target language, translation status and translated content.

Error response (e.g. request does not exist, wrong format)

{
  "success": false,
  "errors": {
    "not_found": "Translation request not found"
  }
}

In case of error, the response will contain the key success: false and details in the errors section, for example if the ID does not exist or is invalid.

Integration examples

You can check out integration examples available on the official Ovesio GitHub page .