---
title: "Retrieve possible matches to input"
method: GET
path: "/search/{source_lang}"
tags: ["Search"]
---

# Retrieve possible matches to input

`GET /search/{source_lang}`

## Request

- Base URL: `https://od-api-demo.oxforddictionaries.com:443/api/v1`
- URL: `https://od-api-demo.oxforddictionaries.com:443/api/v1/search/{source_lang}`
- Auth: none declared. Required headers: `app_id`, `app_key`

Use this to retrieve possible [headword](documentation/glossary?term=headword) matches for a given string of text. The results are culculated using headword matching, fuzzy matching, and [lemmatization](documentation/glossary?term=lemma) 

  <div id="search"></div>

## Path parameters

- `source_lang` 'en' | 'es' | 'hi' | 'lv' | 'sw' | 'ta' | 'gu', required

## Query parameters

- `q` string
- `prefix` boolean
- `regions` string
- `limit` string
- `offset` string

## Headers

- `app_id` string, required
- `app_key` string, required

## Response `200`

Successful response.

- Wordlist: Schema for wordlist endpoint.
  - `metadata` object: Additional Information provided by OUP
  - `results` object[]: A list of found words
    - `id` string, required: The identifier of a word
    - `matchString` string, nullable
    - `matchType` string
    - `region` string: Name of region.
    - `word` string, required: A given written or spoken realisation of a an entry, lowercased.

## Other responses

- `404`: No entry is found matching supplied id and source_lang or filters are not recognized
- `500`: Internal Error. An error occurred while processing the data.

---

[API](https://skmtc.dev/oxforddictionaries/apis/oxforddictionaries-guest-api.md) - [All operations](https://skmtc.dev/oxforddictionaries/apis/oxforddictionaries-guest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oxforddictionaries/apis/oxforddictionaries-guest-api/revisions/6acbf89f6aeb?raw)