---
title: "Concordance search in TMs"
method: POST
path: "/tms/concordance"
tags: ["Translation Memory"]
---

# Concordance search in TMs

`POST /tms/concordance`

## Request

- Base URL: `https://api.crowdin.com/api/v2`
- URL: `https://api.crowdin.com/api/v2/tms/concordance`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crowdin/apis/crowdin-api-v2/docs/tms/concordance/post.ts> (a function with typed inputs; its response is checked against the schema)

**Required scopes:** `tm` (Read only).

## Request body

- CrowdinOrganizationTmConcordanceForm
  - `sourceLanguageId` string, required: Source Language Identifier. Get via [List Supported Languages](#operation/api.languages.getMany)
  - `targetLanguageId` string, required: Target Language Identifier. Get via [List Supported Languages](#operation/api.languages.getMany)
  - `autoSubstitution` boolean, required: Improves TM suggestions
  - `minRelevant` integer, required: Show TM suggestions with specified minimum match
  - `expressions` string[], required: Expressions to search
  - `userId` integer, nullable: Owner (user) whose translation memories to search. Only translation memories you own or manage are searched. Defaults to your own account.

## Response `200`

Concordance Result Collection

- TmConcordanceResultCollectionResource: Base schema of resource container. Container is a wrapper object that contains payload in required `data` property and provides space for adding any other metadata.
  - `data` TmConcordanceResultResource[], required
    - `data` TmConcordanceResult, required
      - `tm` TmConcordance
        - `id` integer
        - `name` string
      - `recordId` integer
      - `source` string
      - `target` string
      - `relevant` integer
      - `substituted` string, nullable
      - `updatedAt` string, date-time, nullable
  - `pagination` Pagination: Pagination Response Model
    - `offset` integer
    - `limit` integer

## Other responses

- `400`: Invalid Request Parameters
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Organization was not found, or you have no translation memories to search
- `405`: Method Not Allowed

---

[API](https://skmtc.dev/crowdin/apis/crowdin-api-v2.md) - [All operations](https://skmtc.dev/crowdin/apis/crowdin-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/crowdin/apis/crowdin-api-v2/revisions/27aae7751699?raw)
