https://github.com/openapi/get-started-with-oauth-v2
📣 ANNOUNCEMENT: The Openapi® OAuth system just got a major upgrade V2.
https://github.com/openapi/get-started-with-oauth-v2
certified-api http-client mcp-server oauth oauth2 oauth2-client openapi restapi
Last synced: about 1 month ago
JSON representation
📣 ANNOUNCEMENT: The Openapi® OAuth system just got a major upgrade V2.
- Host: GitHub
- URL: https://github.com/openapi/get-started-with-oauth-v2
- Owner: openapi
- License: mit
- Created: 2026-04-28T15:00:04.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T17:00:32.000Z (about 2 months ago)
- Last Synced: 2026-04-28T17:24:15.211Z (about 2 months ago)
- Topics: certified-api, http-client, mcp-server, oauth, oauth2, oauth2-client, openapi, restapi
- Language: Makefile
- Homepage: https://console.openapi.com/apis/oauthv2/info
- Size: 216 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
- Code of conduct: docs/code-of-conduct.md
Awesome Lists containing this project
README
🚀 OAuth V2 is now live
Granular token limits · Refresh-token rotation · Wallet transactions · Advanced stats · Full monitoring
[](https://console.openapi.com/apis/oauthv2/info)
[](LICENSE)
[](https://console.openapi.com/support#heading_3779)
[](https://www.linuxfoundation.org/about/members)
**[Read the docs →](https://console.openapi.com/apis/oauthv2/info)**
---
# 🔐 OAuth V2 — Get Started
A curated collection of ready-to-run examples for the **[Openapi OAuth V2 API](https://console.openapi.com/apis/oauthv2/info)** — pick your language, set your credentials, and go.
## What's new in V2?
- **Granular token limits** — cap total requests, paid requests, wallet spend and allowed IPs per token
- **Refresh-token rotation** — extend a token's TTL securely via `PATCH` without losing accumulated stats
- **Wallet transactions** — paginated history of every credit and expense on your account
- **Advanced stats** — aggregate metrics, unique IP lists, and per-domain / per-scope breakdowns
- **Full monitoring** — inspect callback deliveries, active subscriptions and integration error logs
## Documentation
| Resource | Link |
|---|---|
| Getting started guide | [console.openapi.com/apis/oauthv2](https://console.openapi.com/apis/oauthv2/info) |
| API Reference (Swagger UI) | [console.openapi.com/apis/oauthv2/documentation](https://console.openapi.com/apis/oauthv2/documentation#docs-swaggerui) |
| Postman collection | [openapi.com/en/docs/oauth#postman](https://console.openapi.com/apis/oauthv2/documentation) |
| OAS3 specification | [openapi.com/en/docs/oauth#oas3](https://console.openapi.com/apis/oauthv2/documentation) |
## Examples
Each subfolder contains self-contained, runnable examples for a specific language or tool.
| Language / Tool | Folder |
|---|---|
| cURL | [`examples/curl`](examples/curl) |
## Authentication
All endpoints use **HTTP Basic Auth** — your account email as username and your API key as password.
```
Authorization: Basic base64(EMAIL:APIKEY)
```
The only exception is token refresh: pass the refresh token as a **Bearer** token when calling `PATCH /tokens/{token}`.
## Quick start
1. Generate a token from the [Openapi console](https://console.openapi.com/oauth) or via API.
2. Pick the examples folder for your language.
3. Copy the snippet, set your credentials, run it.
## Contributing
Contributions are always welcome! Whether you want to report bugs, suggest new features, improve documentation, or contribute code, your help is appreciated.
See [docs/contributing.md](docs/contributing.md) for detailed instructions on how to get started. Please make sure to follow this project's [docs/code-of-conduct.md](docs/code-of-conduct.md) to help maintain a welcoming and collaborative environment.
## Authors
Meet the project authors:
- Openapi Team ([@openapi-it](https://github.com/openapi-it))
## Partners
Meet our partners using Openapi or contributing to this SDK:
- [Blank](https://www.blank.app/)
- [Credit Safe](https://www.creditsafe.com/)
- [Deliveroo](https://deliveroo.it/)
- [Gruppo MOL](https://molgroupitaly.it/it/)
- [Jakala](https://www.jakala.com/)
- [Octotelematics](https://www.octotelematics.com/)
- [OTOQI](https://otoqi.com/)
- [PWC](https://www.pwc.com/)
- [QOMODO S.R.L.](https://www.qomodo.me/)
- [SOUNDREEF S.P.A.](https://www.soundreef.com/)
## Our Commitments
We believe in open source and we act on that belief. We became Silver Members
of the Linux Foundation because we wanted to formally support the ecosystem
we build on every day. Open standards, open collaboration, and open governance
are part of how we work and how we think about software.
## License
This project is licensed under the [MIT License](LICENSE).
The MIT License is a permissive open-source license that allows you to freely use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software.
In short, you are free to use this SDK in your personal, academic, or commercial projects, with minimal restrictions. The project is provided "as-is", without any warranty of any kind, either expressed or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement.
For more details, see the full license text at the [MIT License page](https://choosealicense.com/licenses/mit/).