Skip to main content

Me

GET Me

https://api.track.toggl.com/api/v9/me

Returns details for the current user.

curl  https://api.track.toggl.com/api/v9/me \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

{"api_token":{"description":"will be omitted if empty","type":"string"},"at":{"type":"string","format":"date-time"},"beginning_of_week":{"type":"integer"},"country_id":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"default_workspace_id":{"type":"integer"},"email":{"type":"string","format":"email"},"fullname":{"type":"string"},"id":{"type":"integer"},"image_url":{"type":"string","example":"http://example.com"},"intercom_hash":{"description":"will be omitted if empty","type":"string"},"openid_email":{"type":"string","format":"email"},"openid_enabled":{"type":"boolean"},"options":{"additionalProperties":"object"},"timezone":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}

PUT Me

https://api.track.toggl.com/api/v9/me

Updates details for the current user.

curl -X PUT https://api.track.toggl.com/api/v9/me \
-H "Content-Type: application/json" \
-d '{"beginning_of_week":"integer","country_id":"integer","current_password":"string","default_workspace_id":"integer","email":"string","fullname":"string","password":"string","timezone":"string"}' \
-u <email>:<password>

Parameters

Body

nametyperequireddescription
beginning_of_weekintegerfalse-
country_idintegerfalse-
current_passwordstringfalse-
default_workspace_idintegerfalse-
emailstringfalse-
fullnamestringfalse-
passwordstringfalse-
timezonestringfalse-

Response

{"api_token":{"description":"will be omitted if empty","type":"string"},"at":{"type":"string","format":"date-time"},"beginning_of_week":{"type":"integer"},"country_id":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"default_workspace_id":{"type":"integer"},"email":{"type":"string","format":"email"},"fullname":{"type":"string"},"id":{"type":"integer"},"image_url":{"type":"string","example":"http://example.com"},"openid_email":{"type":"string","format":"email"},"openid_enabled":{"type":"boolean"},"options":{"additionalProperties":"object"},"timezone":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}

GET Clients

https://api.track.toggl.com/api/v9/me/clients

Get Clients.

curl  https://api.track.toggl.com/api/v9/me/clients \
-H "Content-Type: application/json" \

Response

Successful operation

POST CloseAccount

https://api.track.toggl.com/api/v9/me/close_account

Close Account

curl -X POST https://api.track.toggl.com/api/v9/me/close_account \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

Successful operation.

GET Features

https://api.track.toggl.com/api/v9/me/features

Get features.

curl  https://api.track.toggl.com/api/v9/me/features \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

Successful operation

GET User's last known location

https://api.track.toggl.com/api/v9/me/location

Returns the client's IP-based location. If no data is present, empty response will be yielded.

curl  https://api.track.toggl.com/api/v9/me/location \
-H "Content-Type: application/json" \

Response

{"city":{"type":"string"},"city_lat_long":{"type":"string"},"country_code":{"type":"string"},"country_name":{"type":"string"},"state":{"type":"string"}}

GET Logged

https://api.track.toggl.com/api/v9/me/logged

Returns whether the current user is logged in or not.

curl  https://api.track.toggl.com/api/v9/me/logged \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

Successful operation.

GET LostPassword

https://api.track.toggl.com/api/v9/me/lost_passwords

Verifies the user request to reset the password.

curl  https://api.track.toggl.com/api/v9/me/lost_passwords \
-H "Content-Type: application/json" \

Response

Successful operation

POST LostPassword

https://api.track.toggl.com/api/v9/me/lost_passwords/confirm

Handles lost password request confirmation.

curl -X POST https://api.track.toggl.com/api/v9/me/lost_passwords/confirm \
-H "Content-Type: application/json" \
-d '{"code":"string","password":"string","user_id":"integer"}' \

Parameters

Body

nametyperequireddescription
codestringfalse-
passwordstringfalse-
user_idintegerfalse-

Response

Successful operation

POST LostPassword

https://api.track.toggl.com/api/v9/me/lost_passwords/{token_code}

Handles the users request to reset the password.

curl -X POST https://api.track.toggl.com/api/v9/me/lost_passwords/{token_code} \
-H "Content-Type: application/json" \
-d '{"email":"string"}' \

Parameters

Path

nametyperequireddescription
token_codestringtrueToken Code

Body

nametyperequireddescription
emailstringfalse-

Response

Successful operation

GET Organizations that a user is part of

https://api.track.toggl.com/api/v9/me/organizations

Get all organizations a given user is part of.

curl  https://api.track.toggl.com/api/v9/me/organizations \
-H "Content-Type: application/json" \

Response

Successful operation

GET Projects

https://api.track.toggl.com/api/v9/me/projects

Get projects

curl  https://api.track.toggl.com/api/v9/me/projects \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Query

nametyperequireddescription
include_archivedstringfalseInclude archived

Response

Successful operation

GET ProjectsPaginated

https://api.track.toggl.com/api/v9/me/projects/paginated

Get paginated projects.

curl  https://api.track.toggl.com/api/v9/me/projects/paginated \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Query

nametyperequireddescription
start_project_idstringfalseStart project id

Response

Successful operation

GET Tags

https://api.track.toggl.com/api/v9/me/tags

Returns tags for the current user.

curl  https://api.track.toggl.com/api/v9/me/tags \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

Successful operation.

GET Tasks

https://api.track.toggl.com/api/v9/me/tasks

Returns tasks from projects in which the user is participating.

curl  https://api.track.toggl.com/api/v9/me/tasks \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Query

nametyperequireddescription
sincestringfalsesince
include_not_activestringfalseInclude tasks where active=false

Response

Successful operation.

GET TrackReminders

https://api.track.toggl.com/api/v9/me/track_reminders

Returns a list of track reminders.

curl  https://api.track.toggl.com/api/v9/me/track_reminders \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

Returns a list of track reminders.

GET WebTimer

https://api.track.toggl.com/api/v9/me/web-timer

Get web timer.

curl  https://api.track.toggl.com/api/v9/me/web-timer \
-H "Content-Type: application/json" \
-u <email>:<password>

Response

Successful operation
© 2022 Toggl. All rights reserved.