# ReqRes API

**Provider:** ReqRes
**Category:** developer
**Base URL:** `https://reqres.in`
**Auth:** api-key — `x-api-key: YOUR_API_KEY`
**Rate Limit:** See documentation
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://reqres.in/

## Description

OpenAPI specification for the public ReqRes API on reqres.in. This spec covers legacy demo endpoints, collections, app-user flows, custom endpoints, templates, and onboarding/figma utilities. Schemas stay permissive where responses are dynamic.

Example Applications
See complete apps built on ReqRes: Task Manager | Waitlist App. Source code: Task Manager repo | Waitlist repo.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://reqres.in/api/users` | List users (legacy) |
| POST | `https://reqres.in/api/users` | Create user (legacy) |
| GET | `https://reqres.in/api/users/{id}` | Get user by id (legacy) |
| PUT | `https://reqres.in/api/users/{id}` | Update user (legacy) |
| PATCH | `https://reqres.in/api/users/{id}` | Patch user (legacy) |
| DELETE | `https://reqres.in/api/users/{id}` | Delete user (legacy) |
| GET | `https://reqres.in/api/unknown` | List resources (legacy) |
| GET | `https://reqres.in/api/unknown/{id}` | Get resource by id (legacy) |

## Authentication

API key in the x-api-key request header

```
x-api-key: YOUR_API_KEY
```

## Sample Request

```bash
curl 'https://reqres.in'
```

## Sample Response

```json
{}
```

## Pricing Details

Free — open public API, no authentication required.

---

*Source: [API Map](https://apimap.dev/apis/reqres/) — CC BY 4.0*