This project aims at providing a no-bullshit "Never Have I Ever" experience. Available features are intentionally limited to the bare minimum. Use the provided API to implement own ideas.
We do not advocate overconsumption or the abuse of alcohol. While we hope you have fun playing, please do so responsibly.
Screenshot Dark Screenshot Light
GET https://api.nhie.io/v2/statements/next
{
"ID":"28be7d12-90b4-4846-b86a-73040eff11ec",
"statement":"Never have I ever been stung by a bee.",
"category":"harmless"
}
GET https://api.nhie.io/v1/statements/random
This endpoint is deprecated and might be removed at any time.
Since a surprising amount of other projects still depend on the (previously undocumented) v1
endpoint, we decided to
keep it around as a permanent redirect to the largely compatible v2
endpoint. Note that the history_id
query
parameter is not supported anymore. See duplicate statements for a similar functionality.
Key | Value |
---|---|
category | harmless, delicate or offensive |
language | IETF BCP 47 language tag |
statement_id | UUID of previous statement |
Multiple categories can be queried by adding multiple category
parameters.
A random category is used if no category
parameter is set.
GET https://api.nhie.io/v2/statements/next?category=delicate&category=offensive
The currently supported languages are listed below. More languages might be added in the future.
Language | BCP 47 |
---|---|
English (default) | en |
Deutsch | de |
GET https://api.nhie.io/v2/statements/next?language=de
The statement_id
parameter can be used to avoid duplicate statements during a game session.
All available statements are internally ordered in a random fashion. With statement_id
set,
the returned statement is guaranteed be different from previous statements.
GET https://api.nhie.io/v2/statements/next?statement_id=28be7d12-90b4-4846-b86a-73040eff11ec
Pull requests are welcome. Please open an issue first to discuss what you would like to change.