Search translation memory

curl --request POST \
  --url https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callbackUrl": "<string>",
  "createdAtMax": "2023-11-07T05:31:56Z",
  "createdAtMin": "2023-11-07T05:31:56Z",
  "exportTargetLangs": [
    "<string>"
  ],
  "filename": "<string>",
  "modifiedAtMax": "2023-11-07T05:31:56Z",
  "modifiedAtMin": "2023-11-07T05:31:56Z",
  "queries": [
    "<string>"
  ],
  "queryLangs": [
    "<string>"
  ]
}
'

import requests

url = "https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync"

payload = {
    "callbackUrl": "<string>",
    "createdAtMax": "2023-11-07T05:31:56Z",
    "createdAtMin": "2023-11-07T05:31:56Z",
    "exportTargetLangs": ["<string>"],
    "filename": "<string>",
    "modifiedAtMax": "2023-11-07T05:31:56Z",
    "modifiedAtMin": "2023-11-07T05:31:56Z",
    "queries": ["<string>"],
    "queryLangs": ["<string>"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    callbackUrl: '<string>',
    createdAtMax: '2023-11-07T05:31:56Z',
    createdAtMin: '2023-11-07T05:31:56Z',
    exportTargetLangs: ['<string>'],
    filename: '<string>',
    modifiedAtMax: '2023-11-07T05:31:56Z',
    modifiedAtMin: '2023-11-07T05:31:56Z',
    queries: ['<string>'],
    queryLangs: ['<string>']
  })
};

fetch('https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'callbackUrl' => '<string>',
    'createdAtMax' => '2023-11-07T05:31:56Z',
    'createdAtMin' => '2023-11-07T05:31:56Z',
    'exportTargetLangs' => [
        '<string>'
    ],
    'filename' => '<string>',
    'modifiedAtMax' => '2023-11-07T05:31:56Z',
    'modifiedAtMin' => '2023-11-07T05:31:56Z',
    'queries' => [
        '<string>'
    ],
    'queryLangs' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync"

	payload := strings.NewReader("{\n  \"callbackUrl\": \"<string>\",\n  \"createdAtMax\": \"2023-11-07T05:31:56Z\",\n  \"createdAtMin\": \"2023-11-07T05:31:56Z\",\n  \"exportTargetLangs\": [\n    \"<string>\"\n  ],\n  \"filename\": \"<string>\",\n  \"modifiedAtMax\": \"2023-11-07T05:31:56Z\",\n  \"modifiedAtMin\": \"2023-11-07T05:31:56Z\",\n  \"queries\": [\n    \"<string>\"\n  ],\n  \"queryLangs\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"callbackUrl\": \"<string>\",\n  \"createdAtMax\": \"2023-11-07T05:31:56Z\",\n  \"createdAtMin\": \"2023-11-07T05:31:56Z\",\n  \"exportTargetLangs\": [\n    \"<string>\"\n  ],\n  \"filename\": \"<string>\",\n  \"modifiedAtMax\": \"2023-11-07T05:31:56Z\",\n  \"modifiedAtMin\": \"2023-11-07T05:31:56Z\",\n  \"queries\": [\n    \"<string>\"\n  ],\n  \"queryLangs\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"callbackUrl\": \"<string>\",\n  \"createdAtMax\": \"2023-11-07T05:31:56Z\",\n  \"createdAtMin\": \"2023-11-07T05:31:56Z\",\n  \"exportTargetLangs\": [\n    \"<string>\"\n  ],\n  \"filename\": \"<string>\",\n  \"modifiedAtMax\": \"2023-11-07T05:31:56Z\",\n  \"modifiedAtMin\": \"2023-11-07T05:31:56Z\",\n  \"queries\": [\n    \"<string>\"\n  ],\n  \"queryLangs\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "asyncExport": {
    "asyncRequest": {},
    "exportTargetLangs": [
      "<string>"
    ],
    "queries": [
      {
        "lang": "<string>",
        "query": "<string>"
      }
    ],
    "transMemory": {}
  },
  "asyncRequest": {
    "asyncResponse": {
      "acceptedSegmentsCount": 123,
      "dateCreated": "2023-11-07T05:31:56Z",
      "errorCode": "<string>",
      "errorDesc": "<string>",
      "errorDetails": [
        {
          "args": {},
          "code": "<string>",
          "message": "<string>"
        }
      ],
      "warnings": [
        {
          "args": {},
          "code": "<string>",
          "message": "<string>"
        }
      ]
    },
    "createdBy": {
      "email": "<string>",
      "firstName": "<string>",
      "id": "<string>",
      "lastName": "<string>",
      "uid": "<string>",
      "userName": "<string>"
    },
    "dateCreated": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "parent": "<unknown>",
    "project": {
      "name": "<string>",
      "uid": "<string>"
    }
  }
}

Translation Memory

Search translation memory

Overview Runs an asynchronous TMX export based on optional wildcard/phrase queries and optional metadata filters. The job streams filtered translation units into TMX via the downstream /export_tmx_by_query endpoint. Use downloadExport/{asyncRequestId} to fetch the finished file.

Flow

Caller posts ExportByQueryDto.
Service queues backend export (job metadata marks it asynchronous).
Response contains asyncRequest + asyncExport descriptors so you can poll or receive callbacks.

queries + queryLangs — intersection (AND), optional

queries and queryLangs are optional and must align 1-to-1 when provided.
Each pair applies a search expression to its locale. Multiple pairs are AND-intersected: a TU must satisfy every pair (it must have a TUV in each pair’s locale that matches the query).
Query values: unquoted text = contains; quoted text = phrase; */? wildcards (max 5/10); no regex/boolean operators.
"*" means match-all but the locale filter still applies — the TU must have a TUV in that locale (real AND constraint).
"" (empty string) or null means no constraint — that pair is ignored entirely and does not participate in the AND. Sending all-empty queries is the same as omitting queries altogether.
When queries is omitted or all entries are empty/null, the export falls through to OR-over-exportTargetLangs (see below).

exportTargetLangs — disjunction (OR), optional

Controls which target TUVs are written to the TMX. A TU is kept if it has at least one TUV matching any of the listed locales.
null / omitted — no locale filter; the whole TU is exported with all its target TUVs.
Present but empty (or all entries invalid) — produces an empty TMX (not the same as null).
To export TUs updated in any of N languages (OR semantics), put the N locales in exportTargetLangs and leave queries/queryLangs empty — do NOT put them in queries/queryLangs (that would AND them).

Examples Export TUs that have an es or de TUV (OR — recommended for multi-language sync): { "exportTargetLangs": ["es_es","de_de"] }

Export TUs that have BOTH es AND de TUVs (AND): { "queries": ["*","*"], "queryLangs": ["es_es","de_de"], "exportTargetLangs": ["es_es","de_de"] }

Filtering

Timestamp bounds (createdAtMin/Max, modifiedAtMin/Max) and author filters (createdBy, modifiedBy) narrow the TU set before export.

Output & limits

Output is always TMX, streamed in chunks; filenames follow dto.filename when provided, otherwise backend defaults.
Requests with excessive locales or wildcard limit violations reject with 400.
If no matches remain after filtering, the job still produces an empty TMX.

Callbacks & polling

Provide callbackUrl to receive completion notification from the async mediator; otherwise poll asyncRequest via standard async APIs and download through /downloadExport/{asyncRequestId} when ready.

POST

api2

transMemories

{transMemoryUid}

exportByQueryAsync

Search translation memory

curl --request POST \
  --url https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callbackUrl": "<string>",
  "createdAtMax": "2023-11-07T05:31:56Z",
  "createdAtMin": "2023-11-07T05:31:56Z",
  "exportTargetLangs": [
    "<string>"
  ],
  "filename": "<string>",
  "modifiedAtMax": "2023-11-07T05:31:56Z",
  "modifiedAtMin": "2023-11-07T05:31:56Z",
  "queries": [
    "<string>"
  ],
  "queryLangs": [
    "<string>"
  ]
}
'

import requests

url = "https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync"

payload = {
    "callbackUrl": "<string>",
    "createdAtMax": "2023-11-07T05:31:56Z",
    "createdAtMin": "2023-11-07T05:31:56Z",
    "exportTargetLangs": ["<string>"],
    "filename": "<string>",
    "modifiedAtMax": "2023-11-07T05:31:56Z",
    "modifiedAtMin": "2023-11-07T05:31:56Z",
    "queries": ["<string>"],
    "queryLangs": ["<string>"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    callbackUrl: '<string>',
    createdAtMax: '2023-11-07T05:31:56Z',
    createdAtMin: '2023-11-07T05:31:56Z',
    exportTargetLangs: ['<string>'],
    filename: '<string>',
    modifiedAtMax: '2023-11-07T05:31:56Z',
    modifiedAtMin: '2023-11-07T05:31:56Z',
    queries: ['<string>'],
    queryLangs: ['<string>']
  })
};

fetch('https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'callbackUrl' => '<string>',
    'createdAtMax' => '2023-11-07T05:31:56Z',
    'createdAtMin' => '2023-11-07T05:31:56Z',
    'exportTargetLangs' => [
        '<string>'
    ],
    'filename' => '<string>',
    'modifiedAtMax' => '2023-11-07T05:31:56Z',
    'modifiedAtMin' => '2023-11-07T05:31:56Z',
    'queries' => [
        '<string>'
    ],
    'queryLangs' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync"

	payload := strings.NewReader("{\n  \"callbackUrl\": \"<string>\",\n  \"createdAtMax\": \"2023-11-07T05:31:56Z\",\n  \"createdAtMin\": \"2023-11-07T05:31:56Z\",\n  \"exportTargetLangs\": [\n    \"<string>\"\n  ],\n  \"filename\": \"<string>\",\n  \"modifiedAtMax\": \"2023-11-07T05:31:56Z\",\n  \"modifiedAtMin\": \"2023-11-07T05:31:56Z\",\n  \"queries\": [\n    \"<string>\"\n  ],\n  \"queryLangs\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"callbackUrl\": \"<string>\",\n  \"createdAtMax\": \"2023-11-07T05:31:56Z\",\n  \"createdAtMin\": \"2023-11-07T05:31:56Z\",\n  \"exportTargetLangs\": [\n    \"<string>\"\n  ],\n  \"filename\": \"<string>\",\n  \"modifiedAtMax\": \"2023-11-07T05:31:56Z\",\n  \"modifiedAtMin\": \"2023-11-07T05:31:56Z\",\n  \"queries\": [\n    \"<string>\"\n  ],\n  \"queryLangs\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/exportByQueryAsync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"callbackUrl\": \"<string>\",\n  \"createdAtMax\": \"2023-11-07T05:31:56Z\",\n  \"createdAtMin\": \"2023-11-07T05:31:56Z\",\n  \"exportTargetLangs\": [\n    \"<string>\"\n  ],\n  \"filename\": \"<string>\",\n  \"modifiedAtMax\": \"2023-11-07T05:31:56Z\",\n  \"modifiedAtMin\": \"2023-11-07T05:31:56Z\",\n  \"queries\": [\n    \"<string>\"\n  ],\n  \"queryLangs\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "asyncExport": {
    "asyncRequest": {},
    "exportTargetLangs": [
      "<string>"
    ],
    "queries": [
      {
        "lang": "<string>",
        "query": "<string>"
      }
    ],
    "transMemory": {}
  },
  "asyncRequest": {
    "asyncResponse": {
      "acceptedSegmentsCount": 123,
      "dateCreated": "2023-11-07T05:31:56Z",
      "errorCode": "<string>",
      "errorDesc": "<string>",
      "errorDetails": [
        {
          "args": {},
          "code": "<string>",
          "message": "<string>"
        }
      ],
      "warnings": [
        {
          "args": {},
          "code": "<string>",
          "message": "<string>"
        }
      ]
    },
    "createdBy": {
      "email": "<string>",
      "firstName": "<string>",
      "id": "<string>",
      "lastName": "<string>",
      "uid": "<string>",
      "userName": "<string>"
    },
    "dateCreated": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "parent": "<unknown>",
    "project": {
      "name": "<string>",
      "uid": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

Get a token from auth/login endpoint and then pass it in the Authorization HTTP header in every subsequent API call. For more information visit our help center.

Path Parameters

transMemoryUid

string

required

Translation memory UID

Body

application/json

Export by query request payload

Request body for exportByQueryAsync; specifies query expressions, locales and optional filters

callbackUrl

string

Callback URL to notify when the async export completes

createdAtMax

string<date-time>

Maximum segment creation timestamp filter

createdAtMin

string<date-time>

Minimum segment creation timestamp filter

createdBy

object

Show child attributes

exportTargetLangs

string[]

Target locale(s) for the exported TMX. Optional — if omitted, all target TUVs are exported (OR/disjunction). TUs are kept when they have at least one TUV matching any listed locale.

filename

string

Custom filename for the exported TMX file

modifiedAtMax

string<date-time>

Maximum segment last-modified timestamp filter

modifiedAtMin

string<date-time>

Minimum segment last-modified timestamp filter

modifiedBy

object

Show child attributes

project

object

Reference to an object by its unique identifier

Show child attributes

queries

string[]

Search query strings (one per queryLangs entry). Optional — if omitted or empty, exports all TUs matching targetLocales (OR). When provided, multiple entries are AND-intersected: a TU must satisfy every query. An empty string "" or null entry is ignored (no constraint for that locale); use "*" to require a TUV to exist in a locale without filtering by text.

queryLangs

string[]

Locale for each corresponding queries entry (aligned 1-to-1). Optional — required only when queries is provided; must have the same number of entries.

Response

Response envelope returned by exportByQueryAsync with async request handle and export job details

asyncExport

object

Export job descriptor containing query expressions, locale selections and the source TM reference

Show child attributes

asyncRequest

object

Show child attributes

Export translation memory Import segments

⌘I