OAuth & OIDC docs

OAuth & OIDC API reference

Authorize, token, userinfo, discovery, and JWKS endpoints for auth flows

/api/oauth5 endpointsPagination + delay readyDownload OpenAPI JSONDownload OpenAPI YAMLDownload Postman Collection

Endpoints

Pick the route you want to test.

5 routes

Active selection

GET

/api/oauth/authorize?client_id=demo-app&redirect_uri=https://example.com/callback&response_type=code&scope=openid+profile+email

Sample request

JAVASCRIPT example
1const payload = {
2  "example": "payload"
3}
4fetch('https://fakeapifordevs.vercel.app/api/oauth/authorize?client_id=demo-app&redirect_uri=https://example.com/callback&response_type=code&scope=openid+profile+email&page=1&per_page=5&delay=1', {
5  method: 'GET',
6  headers: { 'Content-Type': 'application/json' }
7})
8  .then(res => res.json())
9  .then(console.log)

Response contract

List responses include pagination metadata and can surface latency information when you add the `delay` query parameter.

Sample response
1{
2  "data": [
3    {
4      "access_token": "at_mock",
5      "token_type": "Bearer",
6      "expires_in": 86400,
7      "id": "undefined-1"
8    },
9    {
10      "access_token": "at_mock",
11      "token_type": "Bearer",
12      "expires_in": 86400,
13      "id": "undefined-2"
14    }
15  ],
16  "pagination": {
17    "page": 1,
18    "perPage": 5,
19    "total": 42,
20    "totalPages": 9
21  },
22  "meta": {
23    "delayMs": 0
24  }
25}

Query controls

These parameters are supported consistently across collection routes.

page

1-indexed page number. Defaults to 1.

per_page

Number of records per page. Defaults to 10, max 50.

q

Optional text search against names, titles, descriptions, or tags where supported.

delay

Simulate latency in seconds (max 10s).

simulate_error

Force realistic failures like 429, 500, 401, or 503 for resilience testing.

pagination_style

Switch between page, cursor, and link-style pagination on supported collections.

cors

Use `cors=restrict` or `cors=preflight` to test browser integration edge cases.

Integration checklist

  • Use `page` and `per_page` when you need predictable list states.
  • Append `delay` to mimic loading and partial-rendering moments.
  • Point internal examples and SDKs to `/api/oauth`.
  • Deep-link the selected method and path when sharing review links.

Playground shortcut

Open the landing page playground with this exact route already selected.

Open playground

https://fakeapifordevs.vercel.app/api/oauth/authorize?client_id=demo-app&redirect_uri=https://example.com/callback&response_type=code&scope=openid+profile+email&page=1&per_page=5&delay=1

Need another domain?

Explore the rest of the library without leaving the docs system.

AuthenticationE-commerceReal EstateSocial MediaFood DeliverySaaS

Keep these docs online

Buy the maintainers a coffee

Coffee donations help us keep OAuth & OIDC accurate, readable, and easier to test with every release.

  • Covers upkeep for oauth docs
  • Funds schema QA sprints
Buy us a coffee

Explore other domains

AuthenticationE-commerceReal EstateSocial MediaFood DeliverySaaSLogisticsPayments