# “Organizations” Endpoint - GET List of users in organization

**URL:** <https://community.toggl.com/t/organizations-endpoint-get-list-of-users-in-organization/201>\
**Category:** API References\
**Tags:** organization, users, api, endpoints, get\
**Created:** [November 22, 2024, 2:28pm UTC](https://community.toggl.com/t/organizations-endpoint-get-list-of-users-in-organization/201 "2024-11-22T14:28:34Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [November 22, 2024, 2:28pm UTC](https://community.toggl.com/t/organizations-endpoint-get-list-of-users-in-organization/201/1 "2024-11-22T14:28:34Z")

</div>

```auto
https://api.track.toggl.com/api/v9/organizations/{organization_id}/users

```

Returns list of users in organization based on set of url parameters: Result is paginated. Pagination params are returned in headers

- cURL
- Go
- Ruby
- JavaScript
- Python
- Rust

```auto
extern crate tokio;extern crate serde_json;use reqwest::{Client};use reqwest::header::{CONTENT_TYPE};#[tokio::main]async fn main() -> Result<(), reqwest::Error> { let client = Client::new().basic_auth("<email>", "<password>"); let json = client.request(Method::GET, "https://api.track.toggl.com/api/v9/organizations/{organization_id}/users".to_string()) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Parameters[​](https://engineering.toggl.com/docs/api/organizations/#parameters-3)

#### Path[​](https://engineering.toggl.com/docs/api/organizations/#path-2)

| name | type | required | description |
| --- | --- | --- | --- |
| organization\_id | integer | true | Numeric ID of the organization |

#### Query[​](https://engineering.toggl.com/docs/api/organizations/#query)

| name | type | required | description |
| --- | --- | --- | --- |
| filter | string | false | Returns records where name or email contains this string |
| active\_status | string | false | List of `active` `inactive` `invited` comma separated(if not present, all statuses) |
| only\_admins | string | false | If true returns admins only |
| groups | string | false | Comma-separated list of groups ids, returns users belonging to these groups only |
| workspaces | string | false | Comma-separated list of workspaces ids, returns users belonging to this workspaces only |
| page | integer | false | Page number, default 1 |
| per\_page | integer | false | Number of items per page, default 50 |
| sort\_dir | string | false | Values ‘asc’ or ‘desc’, result is sorted on ‘names’ column, default ‘asc’ |

### Response[​](https://engineering.toggl.com/docs/api/organizations/#response-3)

#### 200[​](https://engineering.toggl.com/docs/api/organizations/#200-3)

| Name | Type | Description |
| --- | --- | --- |
| items | Array of object | - |

##### items[​](https://engineering.toggl.com/docs/api/organizations/#items)

| Name | Type | Description |
| --- | --- | --- |
| admin | boolean | Deprecated, to be removed. Use RoleID, or IsAdmin method if you must access this field. |
| avatar\_url | string | - |
| can\_edit\_email | boolean | - |
| created\_at | string | - |
| email | string | - |
| groups | Array of object | - |
| id | integer | - |
| inactive | boolean | - |
| invitation\_id | integer | - |
| joined | boolean | - |
| name | string | - |
| organization\_id | integer | - |
| owner | boolean | Deprecated, to be removed. Use RoleID, or IsOwner method if you must access this field. |
| role\_id | integer | - |
| updated\_at | string | - |
| user\_id | integer | - |
| workspace\_count | integer | - |
| workspaces | Array of object | - |

##### groups[​](https://engineering.toggl.com/docs/api/organizations/#groups)

| Name | Type | Description |
| --- | --- | --- |
| group\_id | integer | - |
| name | string | - |

##### workspaces[​](https://engineering.toggl.com/docs/api/organizations/#workspaces)

| Name | Type | Description |
| --- | --- | --- |
| admin | boolean | Deprecated, to be removed. Use RoleID, or IsAdmin method if you must access this field. |
| cost | number | - |
| default\_currency | string | - |
| groups | Array of object | - |
| inactive | boolean | - |
| rate | number | - |
| role | string | Deprecated, to be removed |
| role\_id | integer | - |
| view\_edit\_billable\_rates | boolean | - |
| view\_edit\_labor\_costs | boolean | - |
| working\_hours | number | - |
| workspace\_id | integer | - |
| workspace\_name | string | - |
| workspace\_user\_id | integer | - |

##### groups[​](https://engineering.toggl.com/docs/api/organizations/#groups-1)

| Name | Type | Description |
| --- | --- | --- |
| group\_id | integer | - |
| name | string | - |

#### 400[​](https://engineering.toggl.com/docs/api/organizations/#400-2)

Possible error messages:

- Missing or invalid organization\_id.
- active\_status parameter can contain only ‘active’, ‘inactive’ or ‘invited’.
- only\_admins parameter can contain only ‘true’ or ‘false’.
- Invalid value sent for ‘page’.
- page parameter must contain values \> 0.
- Invalid value sent for ‘per\_page’.
- per\_page parameter must contain values \> 0.
- sort\_dir parameter can contain only ‘asc’ or ‘desc’.
- Invalid value sent for ‘groups’.
- Invalid value sent for ‘workspaces’.

#### 403[​](https://engineering.toggl.com/docs/api/organizations/#403-2)

User is not authorized to list the organization users