# “Me” Endpoints - GET Workspaces

**URL:** <https://community.toggl.com/t/me-endpoints-get-workspaces/174>\
**Category:** API References\
**Tags:** workspace, api, parameters, me-endpoint, get\
**Created:** [November 21, 2024, 12:37pm UTC](https://community.toggl.com/t/me-endpoints-get-workspaces/174 "2024-11-21T12:37: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 21, 2024, 12:37pm UTC](https://community.toggl.com/t/me-endpoints-get-workspaces/174/1 "2024-11-21T12:37:34Z")

</div>

```auto
https://api.track.toggl.com/api/v9/me/workspaces

```

Lists workspaces for given user.

- 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/me/workspaces".to_string()) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

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

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

| name | type | required | description |
| --- | --- | --- | --- |
| since | integer | false | Retrieve workspaces created/modified/deleted since this date using UNIX timestamp, including the dates a workspace member got added, removed or updated in the workspace. |

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

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

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

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

| Name | Type | Description |
| --- | --- | --- |
| active\_project\_count | integer | - |
| admin | boolean | Current user is workspace admin Deprecated |
| api\_token | string | deprecated |
| at | string | Timestamp of last workspace change |
| business\_ws | boolean | Workspace on Premium subscription |
| csv\_upload | object | CSV upload data |
| default\_currency | string | Default currency, premium feature, optional, only for existing WS, will be ‘USD’ initially |
| default\_hourly\_rate | number | The default hourly rate, premium feature, optional, only for existing WS, will be 0.0 initially |
| hide\_start\_end\_times | boolean | - |
| ical\_enabled | boolean | Calendar integration enabled |
| ical\_url | string | URL of calendar |
| id | integer | Identifier of the workspace |
| last\_modified | string | Last modification of data in the workspace |
| logo\_url | string | URL of workspace logo |
| max\_data\_retention\_days | integer | How far back free workspaces can access data. |
| name | string | Name of the workspace |
| only\_admins\_may\_create\_projects | boolean | Only admins will be able to create projects, optional, only for existing WS, will be false initially |
| only\_admins\_may\_create\_tags | boolean | Only admins will be able to create tags, optional, only for existing WS, will be false initially |
| only\_admins\_see\_billable\_rates | boolean | Whether only admins will be able to see billable rates, premium feature, optional, only for existing WS. Will be false initially |
| only\_admins\_see\_team\_dashboard | boolean | Only admins will be able to see the team dashboard, optional, only for existing WS, will be false initially |
| organization\_id | integer | Identifier of the organization |
| permissions | string | Permissions list |
| premium | boolean | Workspace on Starter subscription |
| profile | integer | deprecated |
| projects\_billable\_by\_default | boolean | New projects billable by default |
| projects\_enforce\_billable | boolean | Whether tracking time to projects will enforce billable setting to be respected. |
| projects\_private\_by\_default | boolean | Workspace setting for default project visbility. |
| rate\_last\_updated | string | Timestamp of last workspace rate update |
| reports\_collapse | boolean | Whether reports should be collapsed by default, optional, only for existing WS, will be true initially |
| role | string | Role of the current user in the workspace |
| rounding | integer | Default rounding, premium feature, optional, only for existing WS. 0 - nearest, 1 - round up, -1 - round down |
| rounding\_minutes | integer | Default rounding in minutes, premium feature, optional, only for existing WS |
| subscription | object | deprecated |
| suspended\_at | string | Timestamp of suspension |
| te\_constraints | object | Time entry constraints setting |
| working\_hours\_in\_minutes | integer | Working hours in minutes |

##### csv\_upload[​](https://engineering.toggl.com/docs/api/me/#csv_upload-1)

| Name | Type | Description |
| --- | --- | --- |
| at | string | - |
| log\_id | integer | - |

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

| Name | Type | Description |
| --- | --- | --- |
| auto\_renew | boolean | - |
| card\_details | object | - |
| company\_id | integer | - |
| contact\_detail | object | - |
| created\_at | string | - |
| currency | string | - |
| customer\_id | integer | - |
| deleted\_at | string | - |
| last\_pricing\_plan\_id | integer | - |
| organization\_id | integer | - |
| payment\_details | object | - |
| pricing\_plan\_id | integer | - |
| renewal\_at | string | - |
| subscription\_id | integer | - |
| subscription\_period | object | - |
| workspace\_id | integer | - |

##### card\_details[​](https://engineering.toggl.com/docs/api/me/#card_details-1)

| Name | Type | Description |
| --- | --- | --- |
| added\_at | string | - |
| card\_number | string | - |
| card\_type | string | - |
| creator\_id | integer | - |
| creator\_name | string | - |
| expiry\_date | string | - |
| holder\_name | string | - |

##### contact\_detail[​](https://engineering.toggl.com/docs/api/me/#contact_detail-1)

| Name | Type | Description |
| --- | --- | --- |
| company\_address | string | - |
| company\_city | string | - |
| company\_name | string | - |
| contact\_detail\_id | integer | - |
| contact\_email | string | - |
| contact\_person | string | - |
| country\_id | integer | - |
| country\_subdivision\_id | integer | - |
| created\_at | string | - |
| customer\_id | integer | - |
| is\_eu\_resident | boolean | - |
| updated\_at | string | - |
| user\_id | integer | - |
| vat\_number | string | - |
| vat\_number\_valid | boolean | DEPRECATED |
| vat\_number\_validated\_at | string | DEPRECATED |
| zip\_code | string | - |

##### payment\_details[​](https://engineering.toggl.com/docs/api/me/#payment_details-1)

| Name | Type | Description |
| --- | --- | --- |
| created\_at | string | - |
| currency | string | - |
| customer\_id | integer | - |
| payment\_type | string | - |
| reference | string | - |
| user\_id | integer | - |

##### subscription\_period[​](https://engineering.toggl.com/docs/api/me/#subscription_period-1)

| Name | Type | Description |
| --- | --- | --- |
| created\_at | string | - |
| finished\_on | string | - |
| started\_on | string | - |
| subscription\_id | integer | - |
| subscription\_period\_id | integer | - |
| trial | boolean | - |
| user\_count | integer | - |

##### te\_constraints[​](https://engineering.toggl.com/docs/api/me/#te_constraints-1)

| Name | Type | Description |
| --- | --- | --- |
| description\_present | boolean | - |
| project\_present | boolean | - |
| tag\_present | boolean | - |
| task\_present | boolean | - |
| time\_entry\_constraints\_enabled | boolean | - |

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

User does not have access to this resource.

#### 500[​](https://engineering.toggl.com/docs/api/me/#500-12)

Internal Server Error