Skip to main content
GET
/
api
/
v1
/
users
curl -X GET "https://api.openwearables.com/api/v1/users?page=1&limit=20&sort_by=created_at&sort_order=desc" \
  -H "X-API-Key: your_api_key_here"

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2024-01-15T10:30:00Z",
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "external_user_id": "ext_user_12345"
    },
    {
      "id": "223e4567-e89b-12d3-a456-426614174001",
      "created_at": "2024-01-14T09:15:00Z",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "[email protected]",
      "external_user_id": null
    }
  ],
  "total": 45,
  "page": 1,
  "limit": 20,
  "pages": 3
}

​
Authentication

This endpoint requires API key authentication. Include your API key in the request header: 
X-API-Key: your_api_key_here

​
Query Parameters

​
page
integer
default:"1"
Page number (1-based). Must be at least 1.
​
limit
integer
default:"20"
Number of results per page. Must be between 1 and 100.
​
sort_by
string
default:"created_at"
Field to sort by. Options: created_at, email, first_name, last_name
​
sort_order
string
default:"desc"
Sort order. Options: asc, desc
​
search
string
Search term to filter users. Performs partial match across first_name, last_name, and email fields.
​
email
string
Filter by exact email match.
​
external_user_id
string
Filter by external user ID.

​
Response

​
items
array
Array of user objects
​
total
integer
Total number of users matching the query
​
page
integer
Current page number
​
limit
integer
Number of results per page
​
pages
integer
Total number of pages available
curl -X GET "https://api.openwearables.com/api/v1/users?page=1&limit=20&sort_by=created_at&sort_order=desc" \
  -H "X-API-Key: your_api_key_here"

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2024-01-15T10:30:00Z",
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "external_user_id": "ext_user_12345"
    },
    {
      "id": "223e4567-e89b-12d3-a456-426614174001",
      "created_at": "2024-01-14T09:15:00Z",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "[email protected]",
      "external_user_id": null
    }
  ],
  "total": 45,
  "page": 1,
  "limit": 20,
  "pages": 3
}

Build docs developers (and LLMs) love

Get started for freeTalk to us