> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timbrix.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User by ID

> ⚠️ SECURITY: Retrieves user profile by ID. Requires authentication with scope "read:user". Supports both OAuth tokens and API keys.

Retrieves user information by user ID.

## Permissions

Can only view users within your organization(s).

## Response

Returns basic user profile information.

## Example

```bash theme={null}
curl -X GET http://localhost:3001/api/users/123 \
  -H "Authorization: Bearer <token>"
```


## OpenAPI

````yaml GET /users/{id}
openapi: 3.1.0
info:
  title: Timbrix API
  description: >-
    REST API with OAuth2 server for managing organizations, members, and
    webhooks
  version: '1.0'
  contact: {}
servers:
  - url: http://sandbox.mintlify.com
    description: Sandbox environment
  - url: http://localhost:3001/api
    description: Local development
security: []
tags:
  - name: organizations
    description: Organization management endpoints
  - name: oauth
    description: OAuth2 authentication and authorization
  - name: webhooks
    description: Webhook configuration and delivery
  - name: users
    description: User information endpoints
  - name: api-keys
    description: API Keys management and validation
paths:
  /users/{id}:
    get:
      tags:
        - users
      summary: Get user by ID
      description: >-
        ⚠️ SECURITY: Retrieves user profile by ID. Requires authentication with
        scope "read:user". Supports both OAuth tokens and API keys.
      operationId: UsersController_getById
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: User retrieved successfully. Returns user profile information.
        '401':
          description: Authentication required. Provide a valid OAuth token.
        '403':
          description: 'Insufficient scope. Required scope: read:user'
        '404':
          description: User not found with the provided ID.
      security:
        - apiKey: []
        - bearer: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'API Key for authentication (format: sk_...)'
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````