1. Entry data
Macquarie Dictionary API
  • Introduction
  • About the databases
  • About the data
  • Searching
    • Entry data
      POST
    • Definition data
      POST
  • Entry data
    • Definition IDs and numbers
      GET
    • Etymology
      GET
    • Headword
      GET
    • Last edited
      GET
    • Run-on entries
      GET
    • Search terms
      GET
    • Usage notes
      GET
  • Definition data
    • Abbreviations
      GET
    • Bynames
      GET
    • Cross-references
      GET
    • Contextual note
      GET
    • Definition text
      GET
    • Encyclopedic subheads
      GET
    • Etymology
      GET
    • Geographic information
      GET
    • Grammatical notes
      GET
    • Headword modifiers
      GET
    • Illustrative phrases
      GET
    • Inflections
      GET
    • Labels
      GET
    • Parts of speech
      GET
    • Pronunciations
      GET
    • Scientific information
      GET
    • Search terms
      GET
    • Subheads
      GET
    • Sublabels
      GET
    • Symbols
      GET
    • Variants
      GET
  1. Entry data

Usage notes

Developing
GET
/{database}/entries/{entry-id}/usage-notes
Retrieves the usage notes of an entry matching the given ID.

Request

Authorization
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
Path Params

Query Params

Request Code Samples

Shell
JavaScript
Swift
Go
PHP
Python
R
Request Request Example
Shell
JavaScript
Swift
Go
curl --location 'https://api.data.macquariedictionary.com.au/complete/entries/5a93641c-27c0-3fd0-b10d-bafaca552d1b/usage-notes?phonemic-transcription=md' \
--header 'X-Api-Key: <api-key>'

Responses

🟢200Success
application/json
Bodyapplication/json

Examples
[
    {
        "data": "The <b>ozone layer</b> is the layer of ozone which settles at between 15 and 30 kilometres altitude and protects the earth from ultraviolet radiation. Stratospheric ozone is formed by the stable form of oxygen, O<sub>2</sub>, being split by ultraviolet radiation, for instance in a lightning strike. It is the major absorber of ultraviolet radiation in the wavelength range 280–320 nanometres which has been shown to be harmful in excessive amounts for plants, animals, and humans. Over the last 50 years the earth’s whole ozone layer has thinned. The density of the ozone layer is not standard around the globe, being least dense over the equator and most dense at latitudes higher than 50° N and 50° S. The discovery in 1985 of a hole in the ozone layer above Antarctica led to the agreement as part of the Montreal Protocol to ban man-made chlorofluorocarbons. Thirty years later in 2015, one of the three UK scientists of the British Antarctic Survey who reported the hole was of the opinion that it could take well into the second half of the twenty first century to repair the ozone layer fully. See also <span data-macquarie-type=\"cross-reference\" data-type=\"link\" data-entry=\"ebec6f0c-e198-325c-8dd6-5cf38996d54a\"><b>ozone</b></span>; <span data-macquarie-type=\"cross-reference\" data-type=\"link\" data-entry=\"46001d81-f0bf-35c2-a933-5c7bfb65dfbd\"><b>ozone depletion</b></span>.",
        "type": "env"
    }
]
🟠400Bad request
🟠404Not found
🔴500Internal server error
Modified at 2026-10-07 05:04:21
Previous
Search terms
Next
Abbreviations
Built with