Skip to main content
GET
/
api
/
v1
/
projects
/
{project_id}
/
users
curl -X GET "https://api.devkit4ai.com/api/v1/projects/123e4567-e89b-12d3-a456-426614174000/users" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "users": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "[email protected]",
      "full_name": "John Doe",
      "is_active": true,
      "created_at": "2024-01-15T10:30:00Z",
      "joined_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "email": "[email protected]",
      "full_name": "Jane Smith",
      "is_active": true,
      "created_at": "2024-01-16T14:20:00Z",
      "joined_at": "2024-01-16T14:20:00Z"
    }
  ],
  "total": 45,
  "page": 1,
  "page_size": 50
}
Retrieve a paginated list of end users for a specific project. Supports search and filtering capabilities.

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
project_id
string
required
Project unique identifier (UUID format)

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination (minimum: 1)
​
page_size
integer
default:"50"
Number of users per page (minimum: 1, maximum: 100)
​
search
string
Search term to filter users by email or name
​
is_active
boolean
Filter by active status

​
Response

​
users
array
required
Array of user objects
​
total
integer
required
Total number of users in the project matching the query
​
page
integer
required
Current page number
​
page_size
integer
required
Number of users per page
curl -X GET "https://api.devkit4ai.com/api/v1/projects/123e4567-e89b-12d3-a456-426614174000/users" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "users": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "[email protected]",
      "full_name": "John Doe",
      "is_active": true,
      "created_at": "2024-01-15T10:30:00Z",
      "joined_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "email": "[email protected]",
      "full_name": "Jane Smith",
      "is_active": true,
      "created_at": "2024-01-16T14:20:00Z",
      "joined_at": "2024-01-16T14:20:00Z"
    }
  ],
  "total": 45,
  "page": 1,
  "page_size": 50
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
project_id
string<uuid>
required

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
page_size
integer
default:50
Required range: 1 <= x <= 100
​
search
string | null
​
is_active
boolean | null

Response

Successful Response

​
users
ProjectUserResponse · object[]
required
​
total
integer
required
​
page
integer
required
​
page_size
integer
required