openapi: 3.0.0
servers:
  - url: https://api.wordnik.com/v4
info:
  description: Wordnik is the worlds biggest online English dictionary, by number of words
  title: Wordnik
  version: "4.0"
  x-apisguru-categories:
    - text
  x-logo:
    url: https://wordnik.com/img/logo-wordnik-home.png
  x-origin:
    - converter:
        url: https://github.com/mermade/oas-kit
        version: 2.6.2
      format: openapi
      url: https://developer.wordnik.com/api-docs/swagger.json
      version: "3.0"
  x-providerName: wordnik.com
externalDocs:
  url: http://developer.wordnik.com/
security:
  - {}
tags:
  - name: word
  - name: words
paths:
  "/word.json/{word}/audio":
    get:
      description: The metadata includes a time-expiring fileUrl which allows reading the audio file directly from the API.  Currently only audio pronunciations from the American Heritage Dictionary in mp3 format are supported.
      operationId: getAudio
      parameters:
        - description: Word to get audio for.
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 50
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/AudioFile"
                type: array
          description: No response was specified
      summary: Fetches audio metadata for a word.
      tags:
        - word
  "/word.json/{word}/definitions":
    get:
      operationId: getDefinitions
      parameters:
        - description: Word to return definitions for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 200
            format: int32
            type: integer
        - description: CSV list of part-of-speech types
          in: query
          name: partOfSpeech
          required: false
          schema:
            enum:
              - noun
              - adjective
              - verb
              - adverb
              - interjection
              - pronoun
              - preposition
              - abbreviation
              - affix
              - article
              - auxiliary-verb
              - conjunction
              - definite-article
              - family-name
              - given-name
              - idiom
              - imperative
              - noun-plural
              - noun-posessive
              - past-participle
              - phrasal-prefix
              - proper-noun
              - proper-noun-plural
              - proper-noun-posessive
              - suffix
              - verb-intransitive
              - verb-transitive
            type: string
        - description: Return related words with definitions
          in: query
          name: includeRelated
          required: false
          schema:
            default: "false"
            type: string
        - description: "Source dictionary to return definitions from.  If 'all' is received, results are returned from all sources. If multiple values are received (e.g. 'century,wiktionary'), results are returned from the first specified dictionary that has definitions. If left blank, results are returned from the first dictionary that has definitions. By default, dictionaries are searched in this order: ahd-5, wiktionary, webster, century, wordnet"
          explode: false
          in: query
          name: sourceDictionaries
          required: false
          schema:
            enum:
              - all
              - ahd-5
              - century
              - wiktionary
              - webster
              - wordnet
            items:
              type: string
            type: array
          style: form
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Return a closed set of XML tags in response
          in: query
          name: includeTags
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/Definition"
                type: array
          description: No response was specified
      summary: Return definitions for a word
      tags:
        - word
  "/word.json/{word}/etymologies":
    get:
      operationId: getEtymologies
      parameters:
        - description: Word to return
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  type: string
                type: array
          description: No response was specified
      summary: Fetches etymology data
      tags:
        - word
  "/word.json/{word}/examples":
    get:
      operationId: getExamples
      parameters:
        - description: Word to return examples for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: Show duplicate examples from different sources
          in: query
          name: includeDuplicates
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Results to skip
          in: query
          name: skip
          required: false
          schema:
            default: 0
            format: int32
            type: integer
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 5
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/ExampleSearchResults"
          description: No response was specified
      summary: Returns examples for a word
      tags:
        - word
  "/word.json/{word}/frequency":
    get:
      operationId: getWordFrequency
      parameters:
        - description: Word to return
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Starting Year
          in: query
          name: startYear
          required: false
          schema:
            default: 1800
            format: int32
            type: integer
        - description: Ending Year
          in: query
          name: endYear
          required: false
          schema:
            default: 2012
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/FrequencySummary"
          description: No response was specified
      summary: Returns word usage over time
      tags:
        - word
  "/word.json/{word}/hyphenation":
    get:
      operationId: getHyphenation
      parameters:
        - description: Word to get syllables for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: "Get from a single dictionary. Valid options: ahd-5, century, wiktionary, webster, and wordnet."
          in: query
          name: sourceDictionary
          required: false
          schema:
            enum:
              - ahd-5
              - century
              - wiktionary
              - webster
              - wordnet
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 50
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/Syllable"
                type: array
          description: No response was specified
      summary: Returns syllable information for a word
      tags:
        - word
  "/word.json/{word}/phrases":
    get:
      operationId: getPhrases
      parameters:
        - description: Word to fetch phrases for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 5
            format: int32
            type: integer
        - description: Minimum WLMI for the phrase
          in: query
          name: wlmi
          required: false
          schema:
            default: 0
            format: int32
            type: integer
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/Bigram"
                type: array
          description: No response was specified
      summary: Fetches bi-gram phrases for a word
      tags:
        - word
  "/word.json/{word}/pronunciations":
    get:
      operationId: getTextPronunciations
      parameters:
        - description: Word to get pronunciations for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Get from a single dictionary
          in: query
          name: sourceDictionary
          required: false
          schema:
            enum:
              - ahd-5
              - century
              - cmu
              - macmillan
              - wiktionary
              - webster
              - wordnet
            type: string
        - description: Text pronunciation type
          in: query
          name: typeFormat
          required: false
          schema:
            enum:
              - ahd-5
              - arpabet
              - gcide-diacritical
              - IPA
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 50
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/TextPron"
                type: array
          description: No response was specified
      summary: Returns text pronunciations for a given word
      tags:
        - word
  "/word.json/{word}/relatedWords":
    get:
      operationId: getRelatedWords
      parameters:
        - description: Word to fetch relationships for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Limits the total results per type of relationship type
          in: query
          name: relationshipTypes
          required: false
          schema:
            enum:
              - synonym
              - antonym
              - variant
              - equivalent
              - cross-reference
              - related-word
              - rhyme
              - form
              - etymologically-related-term
              - hypernym
              - hyponym
              - inflected-form
              - primary
              - same-context
              - verb-form
              - verb-stem
              - has_topic
            type: string
        - description: Restrict to the supplied relationship types
          in: query
          name: limitPerRelationshipType
          required: false
          schema:
            default: 10
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/Related"
                type: array
          description: No response was specified
      summary: Given a word as a string, returns relationships from the Word Graph
      tags:
        - word
  "/word.json/{word}/scrabbleScore":
    get:
      operationId: getScrabbleScore
      parameters:
        - description: Word to get scrabble score for.
          in: path
          name: word
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            "*/*":
              schema:
                format: int64
                type: integer
          description: No response was specified
      summary: Returns the Scrabble score for a word
      tags:
        - word
  "/word.json/{word}/topExample":
    get:
      operationId: getTopExample
      parameters:
        - description: Word to fetch examples for
          in: path
          name: word
          required: true
          schema:
            type: string
        - description: If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.
          in: query
          name: useCanonical
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/Example"
          description: No response was specified
      summary: Returns a top example for a word
      tags:
        - word
  /words.json/randomWord:
    get:
      operationId: getRandomWord
      parameters:
        - description: Only return words with dictionary definitions
          in: query
          name: hasDictionaryDef
          required: false
          schema:
            default: "true"
            type: string
        - description: CSV part-of-speech values to include (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: includePartOfSpeech
          required: false
          schema:
            type: string
        - description: CSV part-of-speech values to exclude (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: excludePartOfSpeech
          required: false
          schema:
            type: string
        - description: Minimum corpus frequency for terms
          in: query
          name: minCorpusCount
          required: false
          schema:
            default: 0
            format: int32
            type: integer
        - description: Maximum corpus frequency for terms
          in: query
          name: maxCorpusCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum dictionary count
          in: query
          name: minDictionaryCount
          required: false
          schema:
            default: 1
            format: int32
            type: integer
        - description: Maximum dictionary count
          in: query
          name: maxDictionaryCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum word length
          in: query
          name: minLength
          required: false
          schema:
            default: 5
            format: int32
            type: integer
        - description: Maximum word length
          in: query
          name: maxLength
          required: false
          schema:
            default: -1
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/WordObject"
          description: No response was specified
      summary: Returns a single random WordObject
      tags:
        - words
  /words.json/randomWords:
    get:
      operationId: getRandomWords
      parameters:
        - description: Only return words with dictionary definitions
          in: query
          name: hasDictionaryDef
          required: false
          schema:
            default: "true"
            type: string
        - description: CSV part-of-speech values to include (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: includePartOfSpeech
          required: false
          schema:
            type: string
        - description: CSV part-of-speech values to exclude (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: excludePartOfSpeech
          required: false
          schema:
            type: string
        - description: Minimum corpus frequency for terms
          in: query
          name: minCorpusCount
          required: false
          schema:
            default: 0
            format: int32
            type: integer
        - description: Maximum corpus frequency for terms
          in: query
          name: maxCorpusCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum dictionary count
          in: query
          name: minDictionaryCount
          required: false
          schema:
            default: 1
            format: int32
            type: integer
        - description: Maximum dictionary count
          in: query
          name: maxDictionaryCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum word length
          in: query
          name: minLength
          required: false
          schema:
            default: 5
            format: int32
            type: integer
        - description: Maximum word length
          in: query
          name: maxLength
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Attribute to sort by
          in: query
          name: sortBy
          required: false
          schema:
            enum:
              - alpha
              - count
            type: string
        - description: Sort direction
          in: query
          name: sortOrder
          required: false
          schema:
            enum:
              - asc
              - desc
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 10
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                items:
                  $ref: "#/components/schemas/WordObject"
                type: array
          description: No response was specified
      summary: Returns an array of random WordObjects
      tags:
        - words
  /words.json/reverseDictionary:
    get:
      operationId: reverseDictionary
      parameters:
        - description: Search term
          in: query
          name: query
          required: true
          schema:
            type: string
        - description: Restricts words and finds closest sense
          in: query
          name: findSenseForWord
          required: false
          schema:
            type: string
        - description: Only include these comma-delimited source dictionaries
          in: query
          name: includeSourceDictionaries
          required: false
          schema:
            enum:
              - ahd-5
              - century
              - cmu
              - macmillan
              - wiktionary
              - webster
              - wordnet
            type: string
        - description: Exclude these comma-delimited source dictionaries
          in: query
          name: excludeSourceDictionaries
          required: false
          schema:
            enum:
              - ahd-5
              - century
              - cmu
              - macmillan
              - wiktionary
              - webster
              - wordnet
            type: string
        - description: Only include these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: includePartOfSpeech
          required: false
          schema:
            type: string
        - description: Exclude these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: excludePartOfSpeech
          required: false
          schema:
            type: string
        - description: Minimum corpus frequency for terms
          in: query
          name: minCorpusCount
          required: false
          schema:
            default: 5
            format: int32
            type: integer
        - description: Maximum corpus frequency for terms
          in: query
          name: maxCorpusCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum word length
          in: query
          name: minLength
          required: false
          schema:
            default: 1
            format: int32
            type: integer
        - description: Maximum word length
          in: query
          name: maxLength
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Expand terms
          in: query
          name: expandTerms
          required: false
          schema:
            type: string
        - description: Return a closed set of XML tags in response
          in: query
          name: includeTags
          required: false
          schema:
            default: "false"
            enum:
              - "false"
              - "true"
            type: string
        - description: Attribute to sort by
          in: query
          name: sortBy
          required: false
          schema:
            enum:
              - alpha
              - count
            type: string
        - description: Sort direction
          in: query
          name: sortOrder
          required: false
          schema:
            enum:
              - asc
              - desc
            type: string
        - description: Results to skip
          in: query
          name: skip
          required: false
          schema:
            default: "0"
            type: string
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 10
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/DefinitionSearchResults"
          description: No response was specified
      summary: Reverse dictionary search
      tags:
        - words
  "/words.json/search/{query}":
    get:
      operationId: searchWords
      parameters:
        - description: Search term is a Regular Expression
          in: query
          name: allowRegex
          required: false
          schema:
            default: "false"
            type: string
        - description: Search query
          in: path
          name: query
          required: true
          schema:
            type: string
        - description: Search case sensitive
          in: query
          name: caseSensitive
          required: false
          schema:
            default: "true"
            type: string
        - description: Only include these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: includePartOfSpeech
          required: false
          schema:
            type: string
        - description: Exclude these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive)
          in: query
          name: excludePartOfSpeech
          required: false
          schema:
            type: string
        - description: Minimum corpus frequency for terms
          in: query
          name: minCorpusCount
          required: false
          schema:
            default: 5
            format: int32
            type: integer
        - description: Maximum corpus frequency for terms
          in: query
          name: maxCorpusCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum number of dictionary entries for words returned
          in: query
          name: minDictionaryCount
          required: false
          schema:
            default: 1
            format: int32
            type: integer
        - description: Maximum dictionary definition count
          in: query
          name: maxDictionaryCount
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Minimum word length
          in: query
          name: minLength
          required: false
          schema:
            default: 1
            format: int32
            type: integer
        - description: Maximum word length
          in: query
          name: maxLength
          required: false
          schema:
            default: -1
            format: int32
            type: integer
        - description: Results to skip
          in: query
          name: skip
          required: false
          schema:
            default: 0
            format: int32
            type: integer
        - description: Maximum number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 10
            format: int32
            type: integer
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/WordSearchResults"
          description: No response was specified
      summary: Searches words
      tags:
        - words
  /words.json/wordOfTheDay:
    get:
      operationId: getWordOfTheDay
      parameters:
        - description: Fetches by date in yyyy-MM-dd
          in: query
          name: date
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            "*/*":
              schema:
                $ref: "#/components/schemas/WordOfTheDay"
          description: No response was specified
      summary: Returns a specific WordOfTheDay
      tags:
        - words
components:
  schemas:
    ApiTokenStatus:
      properties:
        expiresInMillis:
          format: int64
          type: integer
          uniqueItems: false
        remainingCalls:
          format: int64
          type: integer
          uniqueItems: false
        resetsInMillis:
          format: int64
          type: integer
          uniqueItems: false
        token:
          type: string
          uniqueItems: false
        totalRequests:
          format: int64
          type: integer
          uniqueItems: false
        valid:
          type: boolean
          uniqueItems: false
      uniqueItems: false
    AudioFile:
      properties:
        attributionText:
          type: string
          uniqueItems: false
        attributionUrl:
          type: string
          uniqueItems: false
        audioType:
          type: string
          uniqueItems: false
        commentCount:
          format: int32
          type: integer
          uniqueItems: false
        createdAt:
          format: date
          type: string
          uniqueItems: false
        createdBy:
          type: string
          uniqueItems: false
        description:
          type: string
          uniqueItems: false
        duration:
          format: double
          type: number
          uniqueItems: false
        fileUrl:
          type: string
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        voteAverage:
          format: float
          type: number
          uniqueItems: false
        voteCount:
          type: integer
          uniqueItems: false
        voteWeightedAverage:
          format: float
          type: number
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    AudioType:
      properties:
        id:
          format: int32
          type: integer
          uniqueItems: false
        name:
          type: string
          uniqueItems: false
      uniqueItems: false
    AuthenticationToken:
      properties:
        token:
          type: string
          uniqueItems: false
        userId:
          format: int64
          type: integer
          uniqueItems: false
        userSignature:
          type: string
          uniqueItems: false
      uniqueItems: false
    Bigram:
      properties:
        count:
          format: int64
          type: integer
          uniqueItems: false
        gram1:
          type: string
          uniqueItems: false
        gram2:
          type: string
          uniqueItems: false
        mi:
          format: double
          type: number
          uniqueItems: false
        wlmi:
          format: double
          type: number
          uniqueItems: false
      uniqueItems: false
    Category:
      properties:
        id:
          format: int64
          type: integer
          uniqueItems: false
        name:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    Citation:
      properties:
        cite:
          type: string
          uniqueItems: false
        source:
          type: string
          uniqueItems: false
      uniqueItems: false
    ContentProvider:
      properties:
        id:
          format: int32
          type: integer
          uniqueItems: false
        name:
          type: string
          uniqueItems: false
      uniqueItems: false
    Definition:
      properties:
        attributionText:
          type: string
          uniqueItems: false
        attributionUrl:
          type: string
          uniqueItems: false
        citations:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        exampleUses:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        extendedText:
          type: string
          uniqueItems: false
        labels:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        notes:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        partOfSpeech:
          type: string
          uniqueItems: false
        relatedWords:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        score:
          format: float
          type: number
          uniqueItems: false
        seqString:
          type: string
          uniqueItems: false
        sequence:
          type: string
          uniqueItems: false
        sourceDictionary:
          type: string
          uniqueItems: false
        text:
          type: string
          uniqueItems: false
        textProns:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      uniqueItems: false
    DefinitionSearchResults:
      properties:
        results:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        totalResults:
          format: int32
          type: integer
          uniqueItems: false
      uniqueItems: false
    Example:
      properties:
        documentId:
          format: int64
          type: integer
          uniqueItems: false
        exampleId:
          format: int64
          type: integer
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        provider:
          $ref: "#/components/schemas/ContentProvider"
        rating:
          format: float
          type: number
          uniqueItems: false
        score:
          $ref: "#/components/schemas/ScoredWord"
        sentence:
          $ref: "#/components/schemas/Sentence"
        text:
          type: string
          uniqueItems: false
        title:
          type: string
          uniqueItems: false
        url:
          type: string
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
        year:
          type: integer
          uniqueItems: false
      uniqueItems: false
    ExampleSearchResults:
      properties:
        examples:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        facets:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
      uniqueItems: false
    ExampleUsage:
      properties:
        text:
          type: string
          uniqueItems: false
      uniqueItems: false
    Facet:
      properties:
        facetValues:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        name:
          type: string
          uniqueItems: false
      uniqueItems: false
    FacetValue:
      properties:
        count:
          format: int64
          type: integer
          uniqueItems: false
        value:
          type: string
          uniqueItems: false
      uniqueItems: false
    Frequency:
      properties:
        count:
          format: int64
          type: integer
          uniqueItems: false
        year:
          format: int32
          type: integer
          uniqueItems: false
      uniqueItems: false
    FrequencySummary:
      properties:
        frequency:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        frequencyString:
          type: string
          uniqueItems: false
        totalCount:
          format: int64
          type: integer
          uniqueItems: false
        unknownYearCount:
          format: int32
          type: integer
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      uniqueItems: false
    Label:
      properties:
        text:
          type: string
          uniqueItems: false
        type:
          type: string
          uniqueItems: false
      uniqueItems: false
    Long:
      properties:
        value:
          format: int64
          type: integer
          uniqueItems: false
      uniqueItems: false
    Note:
      properties:
        appliesTo:
          items:
            type: string
            uniqueItems: false
          type: array
          uniqueItems: false
        noteType:
          type: string
          uniqueItems: false
        pos:
          format: int32
          type: integer
          uniqueItems: false
        value:
          type: string
          uniqueItems: false
      uniqueItems: false
    PartOfSpeech:
      properties:
        allCategories:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        roots:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        storageAbbr:
          items:
            type: string
            uniqueItems: false
          type: array
          uniqueItems: false
      uniqueItems: false
    Related:
      properties:
        gram:
          type: string
          uniqueItems: false
        label1:
          type: string
          uniqueItems: false
        label2:
          type: string
          uniqueItems: false
        label3:
          type: string
          uniqueItems: false
        label4:
          type: string
          uniqueItems: false
        relationshipType:
          type: string
          uniqueItems: false
        words:
          items:
            type: string
            uniqueItems: false
          type: array
          uniqueItems: false
      uniqueItems: false
    Root:
      properties:
        categories:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        name:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    ScoredWord:
      properties:
        baseWordScore:
          format: double
          type: number
          uniqueItems: false
        docTermCount:
          format: int32
          type: integer
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        lemma:
          type: string
          uniqueItems: false
        partOfSpeech:
          type: string
          uniqueItems: false
        position:
          format: int32
          type: integer
          uniqueItems: false
        score:
          format: float
          type: number
          uniqueItems: false
        sentenceId:
          format: int64
          type: integer
          uniqueItems: false
        stopword:
          type: boolean
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
        wordType:
          type: string
          uniqueItems: false
      uniqueItems: false
    Sentence:
      properties:
        display:
          type: string
          uniqueItems: false
        documentMetadataId:
          format: int64
          type: integer
          uniqueItems: false
        hasScoredWords:
          type: boolean
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        rating:
          format: int32
          type: integer
          uniqueItems: false
        scoredWords:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
      uniqueItems: false
    SimpleDefinition:
      properties:
        note:
          type: string
          uniqueItems: false
        partOfSpeech:
          type: string
          uniqueItems: false
        source:
          type: string
          uniqueItems: false
        text:
          type: string
          uniqueItems: false
      uniqueItems: false
    SimpleExample:
      properties:
        id:
          format: int64
          type: integer
          uniqueItems: false
        text:
          type: string
          uniqueItems: false
        title:
          type: string
          uniqueItems: false
        url:
          type: string
          uniqueItems: false
      uniqueItems: false
    StringValue:
      properties:
        word:
          type: string
          uniqueItems: false
      uniqueItems: false
    Syllable:
      properties:
        seq:
          format: int32
          type: integer
          uniqueItems: false
        text:
          type: string
          uniqueItems: false
        type:
          type: string
          uniqueItems: false
      uniqueItems: false
    TextPron:
      properties:
        raw:
          type: string
          uniqueItems: false
        rawType:
          type: string
          uniqueItems: false
        seq:
          format: int32
          type: integer
          uniqueItems: false
      uniqueItems: false
    User:
      properties:
        displayName:
          type: string
          uniqueItems: false
        email:
          type: string
          uniqueItems: false
        faceBookId:
          type: string
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        password:
          type: string
          uniqueItems: false
        status:
          format: int32
          type: integer
          uniqueItems: false
        userName:
          type: string
          uniqueItems: false
        username:
          type: string
          uniqueItems: false
      uniqueItems: false
    WordList:
      properties:
        createdAt:
          format: date
          type: string
          uniqueItems: false
        description:
          type: string
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        lastActivityAt:
          format: date
          type: string
          uniqueItems: false
        name:
          type: string
          uniqueItems: false
        numberWordsInList:
          format: int64
          type: integer
          uniqueItems: false
        permalink:
          type: string
          uniqueItems: false
        type:
          type: string
          uniqueItems: false
        updatedAt:
          format: date
          type: string
          uniqueItems: false
        userId:
          format: int64
          type: integer
          uniqueItems: false
        username:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    WordListWord:
      properties:
        createdAt:
          format: date
          type: string
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        numberCommentsOnWord:
          format: int64
          type: integer
          uniqueItems: false
        numberLists:
          format: int64
          type: integer
          uniqueItems: false
        userId:
          format: int64
          type: integer
          uniqueItems: false
        username:
          type: string
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    WordObject:
      properties:
        canonicalForm:
          type: string
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        originalWord:
          type: string
          uniqueItems: false
        suggestions:
          items:
            type: string
            uniqueItems: false
          type: array
          uniqueItems: false
        vulgar:
          type: string
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    WordOfTheDay:
      properties:
        category:
          type: string
          uniqueItems: false
        contentProvider:
          $ref: "#/components/schemas/ContentProvider"
        createdAt:
          format: date
          type: string
          uniqueItems: false
        createdBy:
          type: string
          uniqueItems: false
        definitions:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        examples:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        htmlExtra:
          type: string
          uniqueItems: false
        id:
          format: int64
          type: integer
          uniqueItems: false
        note:
          type: string
          uniqueItems: false
        parentId:
          type: string
          uniqueItems: false
        publishDate:
          format: date
          type: string
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      required:
        - id
      uniqueItems: false
    WordSearchResult:
      properties:
        count:
          format: int64
          type: integer
          uniqueItems: false
        lexicality:
          format: double
          type: number
          uniqueItems: false
        word:
          type: string
          uniqueItems: false
      uniqueItems: false
    WordSearchResults:
      properties:
        searchResults:
          items:
            uniqueItems: false
          type: array
          uniqueItems: false
        totalResults:
          format: int32
          type: integer
          uniqueItems: false
      uniqueItems: false
  securitySchemes:
    api_key:
      in: query
      name: api_key
      type: apiKey
