xclade
Admin APIUsers

List Users

Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated.

GET
/admin/users
connect.sid<token>

In: cookie

Query Parameters

fields?string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.

offset?number

The number of items to skip when retrieving a list.

limit?number

Limit the number of items returned in the list.

order?string

The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with -.

q?string

The search term to filter the user's searchable properties.

id?id|
email?string

Filter by an email.

Formatemail
first_name?string

Filter by a first name.

last_name?string

Filter by a last name.

created_at?

Filter by a user's creation date.

updated_at?

Filter by a user's update date.

deleted_at?

Filter by a user's deletion date.

with_deleted?boolean

Whether to include deleted records in the result.

Response Body

application/json

application/json

text/plain

application/json

application/json

application/json

application/json

curl -X GET "https://{tenant}.api.myxclade.com/admin/users"
{
  "limit": 0,
  "offset": 0,
  "count": 0,
  "users": [
    {
      "id": "string",
      "email": "user@example.com",
      "first_name": "string",
      "last_name": "string",
      "avatar_url": "string",
      "metadata": {},
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "deleted_at": "2019-08-24T14:15:22Z"
    }
  ],
  "estimate_count": 0
}

{
  "message": "Discount must be set to dynamic",
  "type": "not_allowed"
}

"Unauthorized"
{
  "message": "Entity with id 1 was not found",
  "type": "not_found"
}
{
  "code": "unknown_error",
  "message": "The request conflicted with another request. You may retry the request with the provided Idempotency-Key.",
  "type": "QueryRunnerAlreadyReleasedError"
}
{
  "code": "invalid_request_error",
  "message": "Discount with code TEST already exists.",
  "type": "duplicate_error"
}

{
  "code": "api_error",
  "message": "An error occured while hashing password",
  "type": "database_error"
}