Skip to main content
GET
/
api
/
v1
/
users
/
{user_id}
Get User
curl --request GET \
  --url https://api.example.com/api/v1/users/{user_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "jsmith@example.com",
  "external_user_id": "<string>",
  "last_synced_at": "2023-11-07T05:31:56Z",
  "last_synced_provider": "<string>",
  "has_active_connection": false
}

Documentation Index

Fetch the complete documentation index at: https://openwearables.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

X-Open-Wearables-API-Key
string | null

Path Parameters

user_id
string<uuid>
required

Response

Successful Response

id
string<uuid>
required
created_at
string<date-time>
required
first_name
string | null
last_name
string | null
email
string<email> | null
external_user_id
string | null
deprecated

Deprecated: no data-fetching endpoint (timeseries, workouts, sleep, summaries, health-scores, etc.) accepts external_user_id - they all require the Open Wearables UUID. This field was added early in the project but never wired into those endpoints, so it only works as a filter on GET /users. Store the UUID returned by POST /users in your own system instead.

last_synced_at
string<date-time> | null
last_synced_provider
string | null
has_active_connection
boolean
default:false