Skip to main content
POST
/
v2
/
evaluation
curl --request POST \ --url https://eu.phrase.com/quality-evaluator/v2/evaluation \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: <content-type>' \ --data ' { "qualityProfileUid": "6804b1c2d3e4f5a6b7c80123", "segments": [ { "id": "segment-1", "source": "Hello, world!", "target": "Hallo, Welt!" } ], "sourceLocaleCode": "en_us", "targetLocaleCode": "de_de" } '
{
  "qualityProfileUid": "6804b1c2d3e4f5a6b7c80123",
  "segments": [
    {
      "id": "segment-1",
      "source": "Hello, world!",
      "target": "Hallo, Welt!",
      "results": [
        {
          "type": "AI_CHECK",
          "aiCheckUid": "6804a3f2e1b2c3d4e5f60789",
          "evaluation": {
            "isValid": true,
            "explanation": "The translation uses standard German sentence structure."
          }
        },
        {
          "type": "AI_CHECK",
          "aiCheckUid": "6804a3f2e1b2c3d4e5f6078a",
          "evaluation": {
            "isValid": false,
            "explanation": "The translation uses informal greeting 'Hallo' instead of formal 'Guten Tag'."
          }
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.phrase.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use a Bearer token obtained from Phrase Platform authentication. See the Authentication guide for details on how to obtain a token.

Headers

​
Content-Type
string
required

Media type of the request body.

Example:

"application/json"

Body

application/json

Request to evaluate translation segments. Exactly one of qualityProfileUid or aiCheckUids must be provided.

​
segments
object[]
required

Segments to evaluate.

Required array length: 1 - 200 elements
​
sourceLocaleCode
string
required

Locale code (e.g., en_us, de_de, fr_fr). Case-insensitive, supports both underscore and hyphen separators.

Example:

"en_us"

​
targetLocaleCode
string
required

Locale code (e.g., en_us, de_de, fr_fr). Case-insensitive, supports both underscore and hyphen separators.

Example:

"en_us"

​
qualityProfileUid
string

UID of the Quality Profile to use for evaluation. Cannot be combined with aiCheckUids.

​
aiCheckUids
string[]

List of AI Check UIDs to evaluate against. Cannot be combined with qualityProfileUid. Maximum 3 items.

Maximum array length: 3

Response

Evaluation completed successfully.

Evaluation results for v2 endpoint.

​
segments
object[]
required

Evaluated segments with all AI Check results nested per segment.

​
qualityProfileUid
string

UID of the Quality Profile used for evaluation. Null when evaluating by AI Check UIDs directly.