# Donatty API > Read-only data of one Donatty streamer: profile, donations, goals, top donors and totals. - Environment: production - Documentation site: https://developers.donatty.com/en/ - API: https://api.donatty.com - Dashboard: https://streamer.donatty.com ## For programs - [OpenAPI 3.1: all routes, parameters and responses](https://developers.donatty.com/en/openapi.json) - [Full documentation text in one file](https://developers.donatty.com/en/llms-full.txt) ## Quick start - [Bot or server](https://developers.donatty.com/en/quickstart/bot.md): Get your channel's latest donations with a terminal request: key, variable, command, moderation statuses. - [Website](https://developers.donatty.com/en/quickstart/website.md): Show a goal, top donors or a total on your own page: a public key, your website address and a request from the browser. ## Example: latest donations ```bash curl -s "https://api.donatty.com/v1/donations?limit=5&moderation=PASSED,NONE" \ -H "Authorization: Bearer $DONATTY_TOKEN" ``` ## All pages in Markdown - [Donatty API documentation](https://developers.donatty.com/en/index.md): The Donatty public API: your channel's donations, goals and top donors in a bot or on a website. - [Keys](https://developers.donatty.com/en/tokens.md): A secret key for a bot, a public key for a website: how to issue, store and replace them. - [Bot or server](https://developers.donatty.com/en/quickstart/bot.md): Get your channel's latest donations with a terminal request: key, variable, command, moderation statuses. - [Website](https://developers.donatty.com/en/quickstart/website.md): Show a goal, top donors or a total on your own page: a public key, your website address and a request from the browser. - [Node.js bot](https://developers.donatty.com/en/examples/bot-node.md): A Node.js bot: every 5 seconds it reads new donations and prints the ones you can show on stream, late approvals included. - [Python bot](https://developers.donatty.com/en/examples/bot-python.md): A Python bot: every 5 seconds it reads new donations and prints the ones you can show on stream, late approvals included. - [Goal on a website (HTML)](https://developers.donatty.com/en/examples/goal-html.md): A page shows the progress of the active goal and refreshes it every 30 seconds: one HTML file with a public key. - [All methods](https://developers.donatty.com/en/reference.md): Five API methods, all GET: the API address, which key each one needs, how “Try a request” works, OpenAPI. - [Streamer profile](https://developers.donatty.com/en/reference/streamer.md): Your public profile: nickname, name, avatar and the donation page link. - [Donations](https://developers.donatty.com/en/reference/donations.md): Your donations, newest first: from Donatty and from Donation Alerts when it is connected. - [Fundraising goals](https://developers.donatty.com/en/reference/goals.md): Your fundraising goals, newest first. - [Top donors](https://developers.donatty.com/en/reference/stats-top.md): The donors with the largest totals for today, this week, month, year or all time. - [Total donated](https://developers.donatty.com/en/reference/stats-total.md): The total donated for today, this week, month, year or all time. - [Working with data](https://developers.donatty.com/en/data.md): Money and time formats, list pages, the goal amount, top donors and totals for a period. - [Rate limits](https://developers.donatty.com/en/rate-limits.md): How many requests a minute secret keys and the public key get, what to do after 429 and how to check what is left. - [FAQ](https://developers.donatty.com/en/faq.md): OBS, test donations, empty lists, rejected donations, webhooks, CORS, keys, rate limits, Donation Alerts, withdrawals. - [API changes](https://developers.donatty.com/en/changelog.md): What changed in the public API: the date, the change and whether code needs updating. - [Errors](https://developers.donatty.com/en/errors.md): Error codes of the public API: what each one means and what to do. - [missing_token](https://developers.donatty.com/en/errors/missing_token.md): HTTP status 401: there is no `Authorization` header. - [invalid_token](https://developers.donatty.com/en/errors/invalid_token.md): HTTP status 401: the key is unknown or malformed. - [token_expired](https://developers.donatty.com/en/errors/token_expired.md): HTTP status 401: the key has expired. - [token_in_query](https://developers.donatty.com/en/errors/token_in_query.md): HTTP status 400: the key is in the request address. - [wrong_token_type](https://developers.donatty.com/en/errors/wrong_token_type.md): HTTP status 403: this is not a key for the public API. - [insufficient_scope](https://developers.donatty.com/en/errors/insufficient_scope.md): HTTP status 403: the key lacks the scope the method requires. - [origin_not_allowed](https://developers.donatty.com/en/errors/origin_not_allowed.md): HTTP status 403: the website address is not allowed for this key. - [invalid_parameter](https://developers.donatty.com/en/errors/invalid_parameter.md): HTTP status 400: a parameter value is not valid. - [not_found](https://developers.donatty.com/en/errors/not_found.md): HTTP status 404: there is no method at this address. - [rate_limited](https://developers.donatty.com/en/errors/rate_limited.md): HTTP status 429: the request limit is exhausted. - [internal_error](https://developers.donatty.com/en/errors/internal_error.md): HTTP status 500: we couldn't complete your request. - [service_unavailable](https://developers.donatty.com/en/errors/service_unavailable.md): HTTP status 503: the API is temporarily unavailable. ## Other language - [Русский](https://developers.donatty.com/llms.txt)