{"resourcePath":"/wordLists","models":{"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"objectName":{"type":"string"},"totalCount":{"type":"long"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"}},"apis":[{"path":"/wordLists.{format}/find/{searchString}","description":"","operations":[{"parameters":[{"name":"searchString","description":"String to search for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects by name.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findByName","responseClass":"List[wordList]","notes":"The term supplied is effectively given a wildcard before and after so 'cat' becomes '%cat%'","httpMethod":"GET"}]},{"path":"/wordLists.{format}","description":"","operations":[{"parameters":[{"description":"WordList to create","required":false,"dataType":"wordList","valueTypeInternal":"com.wordnik.community.entity.WordList","allowMultiple":false,"paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Creates a WordList.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid WordList supplied or mandatory fields are missing.","code":400},{"reason":"Not authenticated.","code":403},{"reason":"WordList owner not found.","code":404}],"nickname":"createWordList","responseClass":"wordList","httpMethod":"POST"}]},{"path":"/wordLists.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a CommentSummary for WordList objects.","responseTypeInternal":"com.wordnik.community.model.CommentSummary","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findMostCommentedOn","responseClass":"List[commentSummary]","notes":"The CommentSummary is sorted by comment count, descending","httpMethod":"GET"}]},{"path":"/wordLists.{format}/containing/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find lists for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects containing a word.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid word or username supplied.","code":400},{"reason":"Not authenticated.","code":403}],"nickname":"findContainingWord","responseClass":"List[wordList]","notes":"Results are scoped to the supplied user.","httpMethod":"GET"}]},{"path":"/wordLists.{format}/recentLists","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"type","description":"WordListType to filter by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordList objects.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findRecentLists","responseClass":"List[wordList]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}