Overview
count matches.Query semantics
query supports * (multi-character, single-token) and ? (single-character) wildcards. Queries map directly to ES query_string, so ordering is flexible and Boolean operators from user input are ignored.query is omitted or blank, the service falls back to *, which matches any source segment.Query examples
Imagine having segment: Good morning
Query:
good morn* → matches Good morning.morn* good → matches Good morning (word order ignored in contains mode).goof morn* → also matches Good morning because any matching token is sufficient.* → matches any TM segment."good morn*" → treated literally; returns no results unless the segment actually contains the quotes.Good morning (no quotes) → matches Good morning.Request limits
count must be between 1 and 50 (default 15).offset must be ≥ 0 (default 0).sourceLang must be a valid locale; targetLangs is optional (defaults to the TM target locales when omitted).Scoring and ordering
grossScore (raw) and score (penalty-adjusted, never negative).score DESC, grossScore DESC, TM order ASC, modified or created timestamp DESC, source TUV ID ASC.Target handling
Validation & errors
count/offset outside allowed bounds, or missing TM access rights yield 400/403.offset + count to detect pagination end (empty page ⇒ done).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.
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.
successful operation