How to hit the ReqRes API

ReqRes at https://reqres.in/api is a hosted fake REST API for testing front ends: users with avatars, pagination, and simulated create, update, and login.

Authentication

ReqRes sends a free x-api-key header in its own examples; the reads below work without one.

Full reference: https://reqres.in/

Get a user

curl https://reqres.in/api/users/2
Run in PostTaco
Example response (trimmed)
{
  "data": {
    "id": 2,
    "email": "[email protected]",
    "first_name": "Janet",
    "last_name": "Weaver",
    "avatar": "https://reqres.in/img/faces/2-image.jpg"
  },
  "support": {
    "url": "https://benhowdle.im/first-cto-playbook?utm_source=reqres&utm_medium=json&utm_campaign=referral",
    "text": "Become a better CTO. A playbook of painful stories and practical advice from a two-time startup CTO."
  },
  "_meta": {
    "powered_by": "ReqRes",
    "docs_url": "https://app.reqres.in/documentation",
    "upgrade_url": "https://app.reqres.in/upgrade",
    "example_url": "https://app.reqres.in/examples/notes-app",
    "variant": "v1_a",
    "message": "Your data persists here. Add auth, logs, and custom schemas to build a real backend.",
    "cta": {
      "label": "See example app",
      "url": "https://app.reqres.in/examples/notes-app"
    },
    "context": "legacy_success"
  }
}

List users (paginated)

curl "https://reqres.in/api/users?page=2&per_page=2"
Run in PostTaco
Example response (trimmed)
{
  "page": 2,
  "per_page": 2,
  "total": 12,
  "total_pages": 6,
  "data": [
    {
      "id": 3,
      "email": "[email protected]",
      "first_name": "Emma",
      "last_name": "Wong",
      "avatar": "https://reqres.in/img/faces/3-image.jpg"
    },
    {
      "id": 4,
      "email": "[email protected]",
      "first_name": "Eve",
      "last_name": "Holt",
      "avatar": "https://reqres.in/img/faces/4-image.jpg"
    }
  ],
  "support": {
    "url": "https://benhowdle.im/first-cto-playbook?utm_source=reqres&utm_medium=json&utm_campaign=referral",
    "text": "Become a better CTO. A playbook of painful stories and practical advice from a two-time startup CTO."
  },
  "_meta": {
    "powered_by": "ReqRes",
    "docs_url": "https://app.reqres.in/documentation",
    "upgrade_url": "https://app.reqres.in/upgrade",
    "example_url": "https://app.reqres.in/examples/notes-app",
    "variant": "v1_a",
    "message": "Your data persists here. Add auth, logs, and custom schemas to build a real backend.",
    "cta": {
      "label": "See example app",
      "url": "https://app.reqres.in/examples/notes-app"
    },
    "context": "legacy_success"
  }
}