> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.ollang.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order by ID

> Retrieve detailed information about a specific translation order by its unique identifier

Retrieve detailed information about a specific translation order using its unique identifier. This endpoint provides comprehensive order details including status, documents, and financial information.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api-integration.ollang.com/integration/orders/60b8d6f1e1b9b1d8c6c0d8e1" \
    -H "X-Api-Key: <your-api-key>"
  ```

  ```javascript JavaScript theme={null}
  const orderId = "60b8d6f1e1b9b1d8c6c0d8e1";

  const response = await fetch(
    `https://api-integration.ollang.com/integration/orders/${orderId}`,
    {
      method: "GET",
      headers: {
        "X-Api-Key": "<your-api-key>",
      },
    },
  );

  const orderData = await response.json();
  ```

  ```python Python theme={null}
  import requests

  order_id = "60b8d6f1e1b9b1d8c6c0d8e1"

  headers = {
      'X-Api-Key': '<your-api-key>'
  }

  response = requests.get(
      f'https://api-integration.ollang.com/integration/orders/{order_id}',
      headers=headers
  )

  order_data = response.json()
  ```

  ```php PHP theme={null}
  $orderId = '60b8d6f1e1b9b1d8c6c0d8e1';

  $curl = curl_init();

  curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://api-integration.ollang.com/integration/orders/' . $orderId,
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => array(
          'X-Api-Key: <your-api-key>'
      ),
  ));

  $response = curl_exec($curl);
  curl_close($curl);
  ```

  ```go Go theme={null}
  package main

  import (
      "fmt"
      "net/http"
  )

  func main() {
      orderId := "60b8d6f1e1b9b1d8c6c0d8e1"
      url := fmt.Sprintf("https://api-integration.ollang.com/integration/orders/%s", orderId)

      req, _ := http.NewRequest("GET", url, nil)
      req.Header.Set("X-Api-Key", "<your-api-key>")

      client := &http.Client{}
      resp, _ := client.Do(req)
  }
  ```

  ```java Java theme={null}
  String orderId = "60b8d6f1e1b9b1d8c6c0d8e1";

  HttpResponse<String> response = Unirest.get("https://api-integration.ollang.com/integration/orders/" + orderId)
    .header("X-Api-Key", "<your-api-key>")
    .asString();
  ```
</RequestExample>

## 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](https://lab.ollang.com).

## Path Parameters

<ParamField path="orderId" type="string" required>
  The unique identifier of the order you want to retrieve. This should be a
  valid order ID that you have access to.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier of the order.
</ResponseField>

<ResponseField name="createdAt" type="string">
  Creation date and time of the order (ISO 8601 format).
</ResponseField>

<ResponseField name="name" type="string">
  Name or title of the order.
</ResponseField>

<ResponseField name="sourceLanguage" type="string">
  Source language of the content. Uses ISO 639-1 language codes (e.g., 'en',
  'tr', 'fr').
</ResponseField>

<ResponseField name="targetLanguage" type="string">
  Target language for translation. Uses ISO 639-1 language codes (e.g., 'en',
  'tr', 'fr').
</ResponseField>

<ResponseField name="type" type="string">
  Type of the order. Creatable values are `cc`, `subtitle`, `document`,
  `aiDubbing`, and `studioDubbing` — see
  [Order Types](/apis/ollang-api-reference/order-types). The platform may
  additionally return legacy or system-generated values such as
  `proofreading`, `other`, or `revision` on orders that were not created
  through [Create Order](/apis/ollang-api-reference/create-order).
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the order. Possible values: `pending`, `ongoing`,
  `completed`, `revision`, `delayed`, `waitingForCC`, `waitingForSubtitle`,
  `delivered`, `qualityCheck`, `readyToSent`.
</ResponseField>

<ResponseField name="rate" type="number">
  Rate applied to the order for pricing calculation.
</ResponseField>

<ResponseField name="projectId" type="string">
  Associated project identifier that this order belongs to.
</ResponseField>

<ResponseField name="level" type="number">
  Service level for the order. Level 0 means full AI generated and Level 1 is
  Human Review added version.
</ResponseField>

<ResponseField name="folderId" type="string">
  Folder identifier where the order files are organized and stored.
</ResponseField>

<ResponseField name="vttUrl" type="string">
  URL to download the VTT subtitle file associated with the order (if
  available).
</ResponseField>

<ResponseField name="orderDocs" type="array">
  Array of documents associated with the order.

  <Expandable title="Document Object Properties">
    <ResponseField name="id" type="string">
      Unique identifier of the document.
    </ResponseField>

    <ResponseField name="name" type="string">
      Name of the document.
    </ResponseField>

    <ResponseField name="url" type="string">
      URL to access or download the document.
    </ResponseField>

    <ResponseField name="type" type="string">
      Type of the document (e.g., sourceVideo, subtitle, translation).
    </ResponseField>

    <ResponseField name="size" type="number">
      Size of the document in bytes.
    </ResponseField>

    <ResponseField name="duration" type="number">
      Duration in seconds (for audio/video files).
    </ResponseField>

    <ResponseField name="wordCount" type="number">
      Word count (for text documents).
    </ResponseField>

    <ResponseField name="sourceLanguage" type="string">
      Source language of the document content.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Document creation date (ISO 8601 format).
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      Document last update date (ISO 8601 format).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="finance" type="object">
  Financial details related to the order.

  <Expandable title="Finance Object Properties">
    <ResponseField name="paymentAmount" type="number">
      Total amount to be paid for this order.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="latestEvaluation" type="object">
  Quality check evaluation for this order, if available. This field is present when a QC evaluation has been run on the order.

  <Expandable title="QC Evaluation Object Properties">
    <ResponseField name="id" type="string">
      Unique identifier of the evaluation.
    </ResponseField>

    <ResponseField name="orderId" type="string">
      Order ID this evaluation belongs to.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Creation timestamp of the evaluation (ISO 8601 format).
    </ResponseField>

    <ResponseField name="textSummary" type="string">
      Text summary of the evaluation results.
    </ResponseField>

    <ResponseField name="scores" type="array">
      Overall evaluation scores for each criterion.

      <Expandable title="Score Object Properties">
        <ResponseField name="name" type="string">
          Name of the evaluation criterion (e.g., "Accuracy", "Fluency").
        </ResponseField>

        <ResponseField name="description" type="string">
          Description of what this criterion measures.
        </ResponseField>

        <ResponseField name="value" type="number">
          Score value for this criterion.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="segmentEvals" type="array">
      Segment-by-segment evaluation details.

      <Expandable title="Segment Evaluation Object Properties">
        <ResponseField name="id" type="string">
          ID of the segment being evaluated.
        </ResponseField>

        <ResponseField name="explain" type="string">
          Explanation of the evaluation for this segment.
        </ResponseField>

        <ResponseField name="suggestedNewValue" type="string">
          Suggested improvement for this segment.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="isLoading" type="boolean">
      Whether the evaluation is still being processed.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "60b8d6f1e1b9b1d8c6c0d8e1",
    "createdAt": "2024-01-15T10:30:00Z",
    "name": "Sample Project - 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/sample_project_fr.vtt",
    "orderDocs": [
      {
        "id": "doc_123abc",
        "name": "Sample Project - Source Video",
        "url": "https://example.com/videos/sample_project.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/sample_project_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
    },
    "latestEvaluation": {
      "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
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Order not found",
    "message": "No order found with the provided orderId",
    "code": "ORDER_NOT_FOUND"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "Access denied",
    "message": "You don't have permission to access this order",
    "code": "ACCESS_DENIED"
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Unauthorized",
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
  ```
</ResponseExample>