Skip to main content
POST
https://api-integration.ollang.com
/
integration
/
orders
/
{orderId}
/
qc
curl -X POST "https://api-integration.ollang.com/integration/orders/60b8d6f1e1b9b1d8c6c0d8e1/qc" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "accuracy": true,
    "fluency": true,
    "tone": true,
    "culturalFit": true,
    "customPrompt": "Please focus on technical terminology accuracy"
  }'

{
  "success": true,
  "message": "QC evaluation started. You will be notified when it's completed.",
  "evalId": "eval_abc123def456",
  "creditsUsed": 5,
  "isProcessing": true
}
Run a standalone QC (Quality Control) evaluation on an existing order. This endpoint triggers an AI-powered assessment of the translation quality, evaluating criteria such as accuracy, fluency, tone, and cultural fit. The evaluation runs asynchronously and you will be notified when it’s completed. 
curl -X POST "https://api-integration.ollang.com/integration/orders/60b8d6f1e1b9b1d8c6c0d8e1/qc" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "accuracy": true,
    "fluency": true,
    "tone": true,
    "culturalFit": true,
    "customPrompt": "Please focus on technical terminology accuracy"
  }'

​
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 for which you want to run the QC evaluation. The order must be in a completed or delivered state to be eligible for evaluation.

​
Request Body

​
accuracy
boolean
default:"true"
Include accuracy evaluation in the QC assessment. This evaluates how accurately the translation conveys the meaning of the source content.
​
fluency
boolean
default:"true"
Include fluency evaluation in the QC assessment. This evaluates how naturally the translation reads in the target language.
​
tone
boolean
default:"true"
Include tone evaluation in the QC assessment. This evaluates whether the translation maintains the appropriate tone and style of the original content.
​
culturalFit
boolean
default:"true"
Include cultural fit evaluation in the QC assessment. This evaluates whether the translation is culturally appropriate for the target audience.
​
customPrompt
string
Optional custom prompt to guide the QC evaluation. Use this to provide specific instructions or focus areas for the AI evaluator, such as “Please focus on technical terminology accuracy” or “Pay attention to formal register consistency”.

​
Response

​
success
boolean
required
Indicates whether the QC evaluation was started successfully.
​
message
string
required
A message describing the result of the request.
​
evalId
string
required
The unique identifier of the created evaluation. Use this ID to track the evaluation status and retrieve results.
​
creditsUsed
number
required
The number of AI credits consumed for this evaluation.
​
isProcessing
boolean
Indicates whether the evaluation is still being processed. When true, the evaluation is running asynchronously and results will be available later.
​
textSummary
string
A text summary of the evaluation results. This field is populated once the evaluation is complete.
​
scores
array
An array of evaluation scores for each criterion. Each score object contains:
  • name: The name of the evaluation criterion (e.g., “accuracy”, “fluency”)
  • score: The numerical score value
  • details: Additional details about the score
​
segmentEvals
array
Segment-by-segment evaluation results. Each segment evaluation contains:
  • segmentId: The identifier of the evaluated segment
  • scores: Array of scores for this specific segment
  • comments: Evaluator comments about this segment
{
  "success": true,
  "message": "QC evaluation started. You will be notified when it's completed.",
  "evalId": "eval_abc123def456",
  "creditsUsed": 5,
  "isProcessing": true
}