Skip to main content
GET
https://api-integration.ollang.com
/
integration
/
orders
/
{orderId}
curl -X GET "https://api-integration.ollang.com/integration/orders/60b8d6f1e1b9b1d8c6c0d8e1" \
  -H "X-Api-Key: <your-api-key>"

{
  "id": "60b8d6f1e1b9b1d8c6c0d8e1",
  "createdAt": "2024-01-15T10:30:00Z",
  "name": "Batman Returns - Episode 1",
  "sourceLanguage": "en",
  "targetLanguage": "fr",
  "type": "cc",
  "status": "completed",
  "rate": 0.15,
  "projectId": "proj_xyz789",
  "level": 0,
  "folderId": "folder_abc123",
  "vttUrl": "https://example.com/subtitles/batman_returns_fr.vtt",
  "orderDocs": [
    {
      "id": "doc_123abc",
      "name": "Batman Returns - Source Video",
      "url": "https://example.com/videos/batman_returns.mp4",
      "type": "sourceVideo",
      "size": 1073741824,
      "duration": 7200,
      "sourceLanguage": "en",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "doc_456def",
      "name": "French Subtitles",
      "url": "https://example.com/subtitles/batman_returns_fr.srt",
      "type": "subtitle",
      "size": 8192,
      "wordCount": 1250,
      "sourceLanguage": "fr",
      "createdAt": "2024-01-16T14:20:00Z",
      "updatedAt": "2024-01-16T14:20:00Z"
    }
  ],
  "finance": {
    "paymentAmount": 150.75
  },
  "qcEvaluation": {
    "id": "eval_abc123def456",
    "orderId": "60b8d6f1e1b9b1d8c6c0d8e1",
    "createdAt": "2024-01-17T09:00:00Z",
    "textSummary": "The translation demonstrates good overall quality with high accuracy and natural fluency. Minor improvements suggested for cultural adaptation.",
    "scores": [
      {
        "name": "Accuracy",
        "description": "Translation accuracy and correctness",
        "value": 92.5
      },
      {
        "name": "Fluency",
        "description": "Natural flow and readability in target language",
        "value": 88.0
      },
      {
        "name": "Tone",
        "description": "Consistency with original tone and style",
        "value": 90.0
      },
      {
        "name": "Cultural Fit",
        "description": "Cultural appropriateness for target audience",
        "value": 85.5
      }
    ],
    "segmentEvals": [
      {
        "id": "seg_001",
        "explain": "Minor grammatical adjustment recommended",
        "suggestedNewValue": "Improved translation text here"
      }
    ],
    "isLoading": false
  }
}
Retrieve detailed information about a specific translation order using its unique identifier. This endpoint provides comprehensive order details including status, documents, and financial information. 
curl -X GET "https://api-integration.ollang.com/integration/orders/60b8d6f1e1b9b1d8c6c0d8e1" \
  -H "X-Api-Key: <your-api-key>"

​
Authorizations

This endpoint requires API key authentication. Include your API key in the request header:
  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard
  • Format: X-Api-Key: your-api-key-here
You can obtain your API key from your Ollang dashboard.

​
Path Parameters

​
orderId
string
required
The unique identifier of the order you want to retrieve. This should be a valid order ID that you have access to.

​
Response

​
id
string
Unique identifier of the order.
​
createdAt
string
Creation date and time of the order (ISO 8601 format).
​
name
string
Name or title of the order.
​
sourceLanguage
string
Source language of the content. Uses ISO 639-1 language codes (e.g., ‘en’, ‘tr’, ‘fr’).
​
targetLanguage
string
Target language for translation. Uses ISO 639-1 language codes (e.g., ‘en’, ‘tr’, ‘fr’).
​
type
string
Type of the order. Possible values: cc, subtitle, document, aiDubbing, studioDubbing, proofreading, other, revision.
​
status
string
Current status of the order. Possible values: pending, ongoing, completed, revision, delayed, waitingForCC, waitingForSubtitle, delivered, qualityCheck, readyToSent.
​
rate
number
Rate applied to the order for pricing calculation.
​
projectId
string
Associated project identifier that this order belongs to.
​
level
number
Service level for the order. Level 0 means full AI generated and Level 1 is Human Review added version.
​
folderId
string
Folder identifier where the order files are organized and stored.
​
vttUrl
string
URL to download the VTT subtitle file associated with the order (if available).
​
orderDocs
array
Array of documents associated with the order.
​
finance
object
Financial details related to the order.
​
qcEvaluation
object
Latest QC evaluation for this order, if available. This field is present when a QC evaluation has been run on the order.
{
  "id": "60b8d6f1e1b9b1d8c6c0d8e1",
  "createdAt": "2024-01-15T10:30:00Z",
  "name": "Batman Returns - Episode 1",
  "sourceLanguage": "en",
  "targetLanguage": "fr",
  "type": "cc",
  "status": "completed",
  "rate": 0.15,
  "projectId": "proj_xyz789",
  "level": 0,
  "folderId": "folder_abc123",
  "vttUrl": "https://example.com/subtitles/batman_returns_fr.vtt",
  "orderDocs": [
    {
      "id": "doc_123abc",
      "name": "Batman Returns - Source Video",
      "url": "https://example.com/videos/batman_returns.mp4",
      "type": "sourceVideo",
      "size": 1073741824,
      "duration": 7200,
      "sourceLanguage": "en",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "doc_456def",
      "name": "French Subtitles",
      "url": "https://example.com/subtitles/batman_returns_fr.srt",
      "type": "subtitle",
      "size": 8192,
      "wordCount": 1250,
      "sourceLanguage": "fr",
      "createdAt": "2024-01-16T14:20:00Z",
      "updatedAt": "2024-01-16T14:20:00Z"
    }
  ],
  "finance": {
    "paymentAmount": 150.75
  },
  "qcEvaluation": {
    "id": "eval_abc123def456",
    "orderId": "60b8d6f1e1b9b1d8c6c0d8e1",
    "createdAt": "2024-01-17T09:00:00Z",
    "textSummary": "The translation demonstrates good overall quality with high accuracy and natural fluency. Minor improvements suggested for cultural adaptation.",
    "scores": [
      {
        "name": "Accuracy",
        "description": "Translation accuracy and correctness",
        "value": 92.5
      },
      {
        "name": "Fluency",
        "description": "Natural flow and readability in target language",
        "value": 88.0
      },
      {
        "name": "Tone",
        "description": "Consistency with original tone and style",
        "value": 90.0
      },
      {
        "name": "Cultural Fit",
        "description": "Cultural appropriateness for target audience",
        "value": 85.5
      }
    ],
    "segmentEvals": [
      {
        "id": "seg_001",
        "explain": "Minor grammatical adjustment recommended",
        "suggestedNewValue": "Improved translation text here"
      }
    ],
    "isLoading": false
  }
}