{"_id":"55369cb24c3edb0d00877c82","editedParams2":true,"project":"55369b3b6a63520d00ae6165","editedParams":true,"version":{"_id":"55369b3b6a63520d00ae6168","__v":1,"project":"55369b3b6a63520d00ae6165","createdAt":"2015-04-21T18:47:23.692Z","releaseDate":"2015-04-21T18:47:23.692Z","categories":["55369b3c6a63520d00ae6169"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":1,"category":{"_id":"55369b3c6a63520d00ae6169","pages":["55369b3c6a63520d00ae616b","55369c446fd3c40d00334964","55369cb24c3edb0d00877c82","5536a68d6a63520d00ae6177","5536a8ff245c930d007ed937"],"version":"55369b3b6a63520d00ae6168","project":"55369b3b6a63520d00ae6165","__v":5,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-21T18:47:24.200Z","from_sync":false,"order":0,"slug":"documentation","title":"Documentation"},"user":"55156c1dbc466623002afea2","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-21T18:53:38.818Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"get","results":{"codes":[]},"auth":"required","params":[{"_id":"55369e446fd3c40d00334977","ref":"","in":"path","required":true,"desc":"Output format (csv or json)","default":"csv","type":"string","name":"format"},{"_id":"55369e446fd3c40d00334976","ref":"","in":"query","required":false,"desc":"ID of a unique Nobel Laureate","default":"","type":"int","name":"id"},{"_id":"55369e446fd3c40d00334975","ref":"","in":"query","required":false,"desc":"Search for laureates by country of birth","default":"","type":"string","name":"bornCountry"},{"_id":"55369e446fd3c40d00334974","ref":"","in":"query","required":false,"desc":"Search for laureates by country of birth based on country code","default":"","type":"string","name":"bornCountryCode"},{"_id":"55369e446fd3c40d00334973","ref":"","in":"query","required":false,"desc":"Search for laureates by city of birth","default":"","type":"string","name":"bornCity"},{"_id":"55369e446fd3c40d00334972","ref":"","in":"query","required":false,"desc":"Search for laureates by country where they died","default":"","type":"string","name":"diedCountry"},{"_id":"55369e446fd3c40d00334971","ref":"","in":"query","required":false,"desc":"Search for laureates by country where they died based on country code","default":"","type":"string","name":"diedCountryCode"},{"_id":"55369e446fd3c40d00334970","ref":"","in":"query","required":false,"desc":"Search for laureates by city where they died","default":"","type":"string","name":"diedCity"},{"_id":"55369e446fd3c40d0033496f","ref":"","in":"query","required":false,"desc":"Search for laureates by year (YYYY) or date (YYYYMMDD) of birth","default":"","type":"string","name":"bornDate"},{"_id":"55369e446fd3c40d0033496e","ref":"","in":"query","required":false,"desc":"End of search for laureaes by year (YYYY) or date (YYYYMMDD) of birth. Requires the bornDate param to be set","default":"","type":"string","name":"bornDateTo"},{"_id":"55369e446fd3c40d0033496d","ref":"","in":"query","required":false,"desc":"Search for laureaes by year (YYYY) or date (YYYYMMDD) of death","default":"","type":"string","name":"diedDate"},{"_id":"55369e446fd3c40d0033496c","ref":"","in":"query","required":false,"desc":"End of search for laureaes by year (YYYY) or date (YYYYMMDD) of death. Requires the diedDate param to be set.","default":"","type":"string","name":"diedDateTo"},{"_id":"55369e446fd3c40d0033496b","ref":"","in":"query","required":false,"desc":"Search for laureates based on the motivation of receiving the prize","default":"","type":"string","name":"motivation"},{"_id":"55369e446fd3c40d0033496a","ref":"","in":"query","required":false,"desc":"Search for laureates by gender (All, Male, Female or Organization)","default":"All","type":"string","name":"gender"},{"_id":"55369e446fd3c40d00334969","ref":"","in":"query","required":false,"desc":"Search for laureates by affiliaton","default":"","type":"string","name":"affiliation"}],"url":"/v1/laureate.:format"},"isReference":false,"order":3,"body":"You need to specify format as either \"json\" or \"csv\". The other parameters are optional. ID corresponds to Laureate id in \"prizes\".","excerpt":"This method allows you to find and list all Nobel Laureates (persons and organizations). One Nobel Laureate may be awarded more than one Nobel Prize. To find the corresponding Nobel Prize(s) that has been awarded a specific Laureate, use the ID parameter that corresponds to Laureate ID parameter in the method \"prizes\".","slug":"laureate","type":"endpoint","title":"Laureate"}

getLaureate

This method allows you to find and list all Nobel Laureates (persons and organizations). One Nobel Laureate may be awarded more than one Nobel Prize. To find the corresponding Nobel Prize(s) that has been awarded a specific Laureate, use the ID parameter that corresponds to Laureate ID parameter in the method "prizes".

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

format:
required
stringcsv
Output format (csv or json)

Query Params

id:
integer
ID of a unique Nobel Laureate
bornCountry:
string
Search for laureates by country of birth
bornCountryCode:
string
Search for laureates by country of birth based on country code
bornCity:
string
Search for laureates by city of birth
diedCountry:
string
Search for laureates by country where they died
diedCountryCode:
string
Search for laureates by country where they died based on country code
diedCity:
string
Search for laureates by city where they died
bornDate:
string
Search for laureates by year (YYYY) or date (YYYYMMDD) of birth
bornDateTo:
string
End of search for laureaes by year (YYYY) or date (YYYYMMDD) of birth. Requires the bornDate param to be set
diedDate:
string
Search for laureaes by year (YYYY) or date (YYYYMMDD) of death
diedDateTo:
string
End of search for laureaes by year (YYYY) or date (YYYYMMDD) of death. Requires the diedDate param to be set.
motivation:
string
Search for laureates based on the motivation of receiving the prize
gender:
stringAll
Search for laureates by gender (All, Male, Female or Organization)
affiliation:
string
Search for laureates by affiliaton

Documentation

You need to specify format as either "json" or "csv". The other parameters are optional. ID corresponds to Laureate id in "prizes".

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}