---
title: "Retrieve corpus sentences for a given word"
method: GET
path: "/entries/{source_language}/{word_id}/sentences"
tags: ["The Sentence Dictionary"]
---

# Retrieve corpus sentences for a given word

`GET /entries/{source_language}/{word_id}/sentences`

## Request

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

Use this to retrieve sentences extracted from  corpora which show how a word is used in the language. This is available for English and Spanish. For English, the sentences are linked to the correct [sense](documentation/glossary?term=sense) of the word in the dictionary. In Spanish, they are linked at the [headword](documentation/glossary?term=headword) level.
  <div id="sentences"></div>

## Path parameters

- `source_language` 'en' | 'es', required
- `word_id` string, required

## Headers

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

## Response `200`

Successful response.

- SentencesResults: Schema for the 'sentences' endpoint
  - `metadata` object: Additional Information provided by OUP
  - `results` SentencesEntry[]: A list of entries and all the data related to them
    - `id` string, required: The identifier of a word
    - `language` string, required: IANA language code
    - `lexicalEntries` SentencesLexicalEntry[], required: A grouping of various senses in a specific language, and a lexical category that relates to a word
      - `grammaticalFeatures` object[]: The different forms are correlated with meanings or functions which we text as 'features'
        - `text` string, required
        - `type` string, required
      - `language` string, required: IANA language code
      - `lexicalCategory` string: A linguistic category of words (or more precisely lexical items), generally defined by the syntactic or morphological behaviour of the lexical item in question, such as noun or verb
      - `sentences` object[], required: A list of written or spoken rendering of examples of use of a word or text
        - `definitions` string[]
        - `domains` string[]
        - `notes` object[]: various types of notes that appear
          - `id` string: The identifier of the word
          - `text` string, required: A note text
          - `type` string, required: The descriptive category of the text
        - `regions` string[]
        - `registers` string[]
        - `senseIds` string[]
        - `text` string, required
        - `translations` object[]: A list of written or spoken rendering of the meaning of a word or text in another language(s)
          - `domains` string[]
          - `grammaticalFeatures` object[]: The different forms are correlated with meanings or functions which we text as 'features'
            - `text` string, required
            - `type` string, required
          - `language` string, required: IANA language code specifying the language of the translation
          - `notes` object[]: various types of notes that appear
            - `id` string: The identifier of the word
            - `text` string, required: A note text
            - `type` string, required: The descriptive category of the text
          - `regions` string[]
          - `registers` string[]
          - `text` string, required
      - `text` string, required: A given written or spoken realisation of a an entry.
    - `type` string: The json object type. Could be 'headword', 'inflection' or 'phrase'
    - `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_language
- `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)