Return a list of users Run in API Explorer

GET /users

Returns the list of all users, sorted by creation date. You can use the page parameter to select the portion of records you want back.

Query parameters

  • page integer

    Select the portion of records you want back.

Responses

  • 200 application/json

    Successful operation, returns the list of users.

    Hide response attributes Show response attributes object
    • id string(uuid)

      ID of the user.

    • createdAt string(date-time)

      Creation date and time.

    • First and last name of the user.

    • jobs array[object]

      List of jobs the user has had.

      Hide jobs attributes Show jobs attributes object
      • title string

        Title of the job.

      • company string

        Name of the company where the user worked.

      • year integer

        Year when the user worked at the company.

    • address object

      One of:

      Personal address of the user if the user doesn't work at a company.

      Hide attributes Show attributes
      • Full address of the user including number, street, postal code and city.

      • country string
GET /users
curl \
 --request GET 'https://reqres.in/api/users'
Response examples (200)
[
  {
    "id": "string",
    "createdAt": "2025-05-04T09:42:00Z",
    "full_name": "John Doe",
    "jobs": [
      {
        "title": "Software Engineer",
        "company": "Bump.sh",
        "year": "2020"
      }
    ],
    "address": {
      "full_address": "25 rue Lenepveu, 49100 Angers",
      "country": "France"
    }
  }
]