---
title: "Start Verification"
method: POST
path: "/lc.verification.startverification/{requestId}"
tags: ["Verification Provider"]
---

# Start Verification

`POST /lc.verification.startverification/{requestId}`

This endpoint initiates the background job for verification. The background job will push messages back to the Verification Service via a publish message URL and then send an asynchronous response once the job has completed.
The response for the callback is given here:
[CallbackResponse](#/schemas/VerificationProvider.MainResponse)

## Headers

- `TR_ID` string
- `x-lc-signature` string

## Request body

- VerificationProviderMainRequest — Request for StartVerification
  - `inputResourceDetails` object, required — input resource details used by the verifiers
    - `nativeFileUrl` string — download URL for the input native source file or for the native target file. The app defines in the descriptor if the native file is a source or target one
    - `bilingualDocumentUrl` string — download URL for the document
    - `bilingualDocumentVersion` integer — version of the document
    - `nativeAnnotatedFileUrl` string — download URL for the input native annotated target file. Annotated source files are currently not supported
    - `languageResourceTemplateId` string — ID for languageResourceTemplate to be used during validation
    - `verificationResourcePackageUrl` string — download URL for verificationResourcePackage
    - `translationProfileId` string — ID used to retrieve resources from the Translation Service via the Trados Cloud Platform API
  - `callbackUrl` string, required — This is the URL detailing endpoint to call when the asynchronous job has completed.
  - `sourceLanguage` string, required — source language code
  - `targetLanguage` string, required — target language code
  - `publishMessageUrl` string, required — upload URL used to publish the verification message results to the platform
  - `verifierSettings` object — JSON settings object containing verifier specific settings
  - `sessionId` string — ID of session this request is associated with

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-01-27** (v1) `9d9d8922a0ce` — 3 info
  - the endpoint scheme security `Trados Cloud Platform JWS Token` was removed from the API
  - added the new optional `header` request parameter `TR_ID`
  - added the new optional `header` request parameter `x-lc-signature`

[Change history](https://skmtc.dev/rws/apis/app-api/changes/lc.verification.startverification/:requestId/post.md)

---

[API](https://skmtc.dev/rws/apis/app-api.md) · [All operations](https://skmtc.dev/rws/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rws/app-api/revisions/a06e1ee1c99b/schema)