Introduction
Welcome to the Timing API reference.
If you prefer a more interactive presentation of the API, you can download our Postman Collection and open it in a tool like Postman or Paw.
We also offer three Siri shortcuts that demonstrate starting and stopping timers via the API:
- Start Timing Timer
- Start Timing Timer (letting you select a project for the timer first)
- Start Fixed Timing Timer (letting you enter timer title and project name once)
- Stop Timing Timer
The "Start Fixed Timing Timer" shortcut will ask you once for a combination of timer title and project name. From then on, it will always launch a shortcut with that combination of title and project. You can create several copies of this shortcut (e.g. by duplicating it), each with a different title/project combination.
Use Cases
Siri Shortcuts and Automation
Using the Timing API, you can quickly create Siri shortcuts to e.g. start and stop timers. During installation, the shortcuts will ask you for an API which you can generate in the 'API Keys' section of the web app. Once installed, simply run the corresponding shortcut to start or stop a timer.
- Start Timing Timer
- Start Timing Timer (letting you select a project for the timer first)
- Start Fixed Timing Timer (letting you enter timer title and project name once)
- Stop Timing Timer
The "Start Fixed Timing Timer" shortcut will ask you once for a combination of timer title and project name. From then on, it will always launch a shortcut with that combination of title and project. You can create several copies of this shortcut (e.g. by duplicating it), each with a different title/project combination.
Feel free to customize these shortcuts to your liking, e.g. by changing the "Start Timer" shortcut to let you select from a couple of preset titles instead. We are also interested in the shortcuts you create, so please let us know what you build with this!
You could also create scripts that start or stop a timer whenever you perform a specific action; see Start a new timer. and Stop the currently running timer. for the corresponding API calls.
Integrating with your billing system
The API also makes it possible to integrate with whatever billing system you are currently using. Simply retrieve your most recent time entries, then send them to your billing system in the desired format. You can also create a script to create a custom report in exactly the format you need, of course.
Make sure to have a look at the ?include_project_data=true
query parameter to include the corresponding project's attributes in the response. This lets you retrieve project titles without having to do a second API call to the "Projects" collection.
GrandTotal integration
The GrandTotal plugin for Timing already uses the Timing Web API to import your team members' time entries. To use that functionality, please refer the corresponding section in the documentation.
Zapier integration
We also offer a Zapier integration. This lets you connect the API to thousands of other services with just a few clicks, solving the problems mentioned above without having to write any code. To start using this integration, see the Zapier section in the web app.
Example use cases include:
- Creating projects for your team members whenever a new project is created in your project management system (e.g. Trello, Asana)
- Importing a list of projects for each team member from a Google Spreadsheet
- Automatically sending finished time entries to your billing system
- Automatically exporting your team members' time entries to a Google Spreadsheet
- Sending a message to a Slack channel whenever you start or stop a task
- Emailing you weekly reports of your team members' logged hours
- And much more...
We also recommend for you to reach out and let us know your desired use cases!
This helps us prioritize which API features to build first.
API Usage
The API root is https://web.timingapp.com/api/v1
. All endpoint URLs share this prefix. Sample code for each available API call can be found in the right-hand column. Note that query parameters need to be URL-encoded, as shown in the Bash example for the Return a list of time entries. call.
Authentication
The Timing API requires authentication with an API key. You can generate a key in the 'API Keys' section of the web app. Once generated, add an Authorization
header to each request with value Bearer {{token}}
, where {{token}}
is your key.
Rate limiting
The API enforces a rate limit of 500 requests per hour. You can retrieve your current quota via the x-ratelimit-remaining
header attached to every request.
Request and response data
The API expects requests and returns responses in the JSON format. The actual response payload can be found in the data
field. Additional data might be provided in the links
and meta
fields described below. Refer to the descriptions of individual API calls for concrete examples.
Date format
As Timing is a time-tracking application, its API has to work with many dates. Dates returned by the API will always be formatted as an ISO8601 string including microseconds as well as the time zone, for example 2019-01-01T00:00:00.000000+00:00
. Currently, all dates returned will be in the UTC timezone, but your code should not make any assumptions about that.
When sending dates in your requests, we recommend providing dates in an ISO8601 format without microseconds but including the time zone, for example 2019-01-01T00:00:00+00:00
or 2019-01-01 00:00:00+00
. When you provide dates without a time zone is provided, Timing currently assumes these date to be in UTC. That may be subject to change, however, so try to provide a timezone with your request whenever possible.
References
The Timing API identifies entities via the self
field, which contains a link relative to the API root, for example /projects/1
. This avoids any ambiguity about the type of the linked resource and provides you with a convenient way of looking it up, without having to look up the correct API call in this documentation: Simply append the link's value to the API root, resulting in e.g. https://web.timingapp.com/api/v1/projects/1
.
References should be treated as opaque strings; your code should not assumptions about their structure.
Shallow references
For API responses that contain related entities, these entities are usually referenced in a "shallow" fashion. Instead of including the full object, a placeholder containing only the self
field is provided, e.g. as "parent": {"self": "/projects/1"}
. For the Return a list of time entries. call, you can append the ?include_project_data=true
query parameter to include the corresponding project's attributes in the response. This lets you retrieve project titles without having to do a second API call to the "Projects" collection.
Links
Some responses include links to related queries or entities. This includes pagination and queries for related entries.
Pagination
By default, collection responses are paginated to 100 items per page. The links to retrieve the first, last, next and previous pages are part of the response's links
field. Additional information about the paginated data can be found in the meta
field.
Projects
Return the complete project hierarchy.
Requires authentication
See Display the specified project. for the returned attributes.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/projects/hierarchy" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/projects/hierarchy"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": [
{
"self": "\/projects\/1",
"team_id": null,
"title": "Project at root level",
"title_chain": [
"Project at root level"
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"children": [
{
"self": "\/projects\/2",
"team_id": null,
"title": "Unproductive child project",
"title_chain": [
"Project at root level",
"Unproductive child project"
],
"color": "#00FF00",
"productivity_score": -1,
"is_archived": false,
"children": [],
"parent": {
"self": "\/projects\/1"
}
}
],
"parent": null
}
]
}
HTTP Request
GET api/v1/projects/hierarchy
Query Parameters
Parameter | Status | Description |
---|---|---|
team_id |
optional | The ID of the team to list projects for. Can be omitted to list the user's private projects. See Return a list containing all the teams you are a member of. for obtaining a team ID to provide here. |
Return a list containing all projects.
Requires authentication
See Display the specified project. for the returned attributes.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/projects?title=root&hide_archived=true" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/projects"
);
let params = {
"title": "root",
"hide_archived": "true",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": [
{
"self": "\/projects\/1",
"team_id": null,
"title": "Project at root level",
"title_chain": [
"Project at root level"
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"children": [
{
"self": "\/projects\/2"
}
],
"parent": null
}
]
}
HTTP Request
GET api/v1/projects
Query Parameters
Parameter | Status | Description |
---|---|---|
title |
optional | Filter for projects whose title contains all words in this parameter. The search is case-insensitive but diacritic-sensitive. |
hide_archived |
optional | If set to true , archived projects and their children will not be included in the result. |
team_id |
optional | The ID of the team to list projects for. Can be omitted to list the user's private projects. See Return a list containing all the teams you are a member of. for obtaining a team ID to provide here. |
Create a new project.
Requires authentication
See Display the specified project. for the returned attributes.
Example request:
curl -X POST \
"https://web.timingapp.com/api/v1/projects" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"title":"Acme Inc.","parent":"\/projects\/1","color":"#FF0000","productivity_score":1,"is_archived":false}'
const url = new URL(
"https://web.timingapp.com/api/v1/projects"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
let body = {
"title": "Acme Inc.",
"parent": "\/projects\/1",
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (201):
{
"data": {
"self": "\/projects\/2",
"team_id": null,
"title": "Acme Inc.",
"title_chain": [
"Project at root level",
"Acme Inc."
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"children": [],
"parent": {
"self": "\/projects\/1"
}
},
"links": {
"time-entries": "https:\/\/web.timingapp.com\/api\/v1\/time-entries?project[]=\/projects\/2"
}
}
HTTP Request
POST api/v1/projects
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
title |
string | required | The project's title. |
parent |
project | optional | A reference to an existing project. The new project will be appended to the parent's children. Can be a project reference in the form "/projects/1" , a project title (e.g. "Project at root level" ), or an array with the project's entire title chain (e.g. ["Project at root level", "Unproductive child project"] ). |
color |
color | optional | The project's color, in hexadecimal format (#RRGGBB ). If omitted, a color with random hue, 70% saturation and 100% value will be used. |
productivity_score |
float | optional | The project's productivity rating, between -1 (very unproductive) and 1 (very productive). Defaults to 1. |
is_archived |
boolean | optional | Whether the project has been archived. Defaults to false. |
team_id |
The | optional | ID of the team to add the project to. See Return a list containing all the teams you are a member of. for obtaining a team ID to provide here. |
Display the specified project.
Requires authentication
The following attributes will be returned:
self
: A reference to the entity itself, relative to the API root.title
: The project's title.title_chain
: An array containing the title of the project and all its ancestors. Example:["Parent", "Child"]
color
: The project's color, in hexadecimal format (#RRGGBB
). Example:#FF0000
productivity_score
: The project's productivity rating, between -1 (very unproductive) and 1 (very productive). Example:1
is_archived
: Whether the project has been archived. Defaults to false. Example:false
parent
: A reference to the enclosing project.children
: The project's children.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/projects/1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/projects/1"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": {
"self": "\/projects\/1",
"team_id": null,
"title": "Project at root level",
"title_chain": [
"Project at root level"
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"children": [
{
"self": "\/projects\/2"
}
],
"parent": null
},
"links": {
"time-entries": "https:\/\/web.timingapp.com\/api\/v1\/time-entries?project[]=\/projects\/1"
}
}
HTTP Request
GET api/v1/projects/{project}
Update the specified project.
Requires authentication
See Display the specified project. for the returned attributes.
Example request:
curl -X PUT \
"https://web.timingapp.com/api/v1/projects/1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"title":"Acme Inc.","color":"#FF0000","productivity_score":1,"is_archived":false}'
const url = new URL(
"https://web.timingapp.com/api/v1/projects/1"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
let body = {
"title": "Acme Inc.",
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false
}
fetch(url, {
method: "PUT",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": {
"self": "\/projects\/1",
"team_id": null,
"title": "Acme Inc.",
"title_chain": [
"Acme Inc."
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"children": [
{
"self": "\/projects\/2"
}
],
"parent": null
},
"links": {
"time-entries": "https:\/\/web.timingapp.com\/api\/v1\/time-entries?project[]=\/projects\/1"
}
}
HTTP Request
PUT api/v1/projects/{project}
PATCH api/v1/projects/{project}
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
title |
string | optional | The project's title. |
color |
color | optional | The project's color, in hexadecimal format (#RRGGBB ). |
productivity_score |
float | optional | The project's productivity rating, between -1 (very unproductive) and 1 (very productive). |
is_archived |
boolean | optional | Whether the project has been archived. |
Delete the specified project and all of its children.
Requires authentication
Example request:
curl -X DELETE \
"https://web.timingapp.com/api/v1/projects/1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/projects/1"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "DELETE",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
HTTP Request
DELETE api/v1/projects/{project}
Reports
Generate a report that can contain both time entries and app usage.
Requires authentication
Returns a JSON array with several rows; each row includes the total duration (in seconds) belonging to the
corresponding other (configurable) columns.
The include_app_usage
and include_team_members
parameters govern whether to include app usage (otherwise, only time entries are returned) as well as data for other team members.
The start_date_min
, start_date_max
, projects
(also see include_child_projects
) and search_query
parameters allow filtering the returned data.
The columns
, project_grouping_level
, include_project_data
, and sort
parameters govern the presentation of the returned data.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/report?include_app_usage=0&include_team_members=0&team_members%5B%5D=%2Fusers%2F1&start_date_min=2019-01-01T00%3A00%3A00%2B00%3A00&start_date_max=2019-01-01T23%3A59%3A59%2B00%3A00&projects%5B%5D=%2Fprojects%2F1&include_child_projects=1&search_query=meeting&columns%5B%5D=project&project_grouping_level=0&include_project_data=1&sort%5B%5D=-duration" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/report"
);
let params = {
"include_app_usage": "0",
"include_team_members": "0",
"team_members[]": "/users/1",
"start_date_min": "2019-01-01T00:00:00+00:00",
"start_date_max": "2019-01-01T23:59:59+00:00",
"projects[]": "/projects/1",
"include_child_projects": "1",
"search_query": "meeting",
"columns[]": "project",
"project_grouping_level": "0",
"include_project_data": "1",
"sort[]": "-duration",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": [
{
"duration": 3600,
"project": {
"self": "\/projects\/1",
"team_id": null,
"title": "Project at root level",
"title_chain": [
"Project at root level"
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"parent": null
}
}
]
}
HTTP Request
GET api/v1/report
Query Parameters
Parameter | Status | Description |
---|---|---|
include_app_usage |
optional | Whether to include app usage in the report. If false, only time entries are returned. Default: 0 |
include_team_members |
optional | If true, the response will also contain time entries that belong to other team members, provided the current user has permission to view them. Default: 0 |
team_members[] |
optional | Restricts the query to data associated with the given user. Can be repeated to include time entries from several users. |
start_date_min |
optional | Restricts the query to data whose start date is equal to or later than this parameter. |
start_date_max |
optional | Restricts the query to data whose start date is equal to or earlier than this parameter. |
projects[] |
optional | Restricts the query to data associated with the given project. Can be repeated to include time entries from several projects. If you would like to include time entries that are not assigned to any project, you can provide an empty string, i.e. projects[]= |
include_child_projects |
optional | If true, the response will also contain time entries that belong to any child projects of the ones provided in projects[] . Default: 0 |
search_query |
optional | Restricts the query to time entries whose title and/or notes contain all words in this parameter. The search is case-insensitive but diacritic-sensitive. Note: this parameter can not be used when app usage is included. |
columns[] |
optional | Which columns to show. The user column is ignored if include_team_members is false. Possible values: project , title , notes , timespan , user . Default: user , project , title . start_date and end_date is shown when timespan column is sent. |
project_grouping_level |
optional | When this argument is provided, report lines for projects below the given level will be aggregated by their parent project on the given level. For example, when project_grouping_level is 0, all times in sub-projects will be counted towards the corresponding project on the "root" (i.e. highest) level in the project tree. Can be a non-negative integer or -1. The default is -1, which indicates no grouping (i.e. all projects will be returned, regardless of how deep they are in the hierarchy). Requires columns[] to contain project . |
include_project_data |
optional | If true, the properties of each line's project will be included in the response. Requires columns[] to contain project . |
sort[] |
optional | Sort the results by the given column. Prepend column name with a dash (- ) to sort descending. Default: -duration . Examples: sort[]=-duration -> Sort descending by duration. sort[]=user&sort[]=-duration -> Sort ascending by user, then descending by duration. |
Teams
Return a list containing all active members of the given team.
Requires authentication
Members with pending invitations will be excluded.
The following attributes will be returned:
self
: A reference to the entity itself, relative to the API root.email
: The team member's email address.name
: The team member's name. May be null if the team member has not entered a name in their account profile.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/teams/1/members" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/teams/1/members"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": [
{
"self": "\/users\/1",
"email": "johnny@appleseed.net",
"name": "Johnny Appleseed"
}
]
}
HTTP Request
GET api/v1/teams/{team}/members
Return a list containing all the teams you are a member of.
Requires authentication
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/teams" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/teams"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": [
{
"id": "\/teams\/1",
"name": "Demo Team"
}
]
}
HTTP Request
GET api/v1/teams
Time Entries
Start a new timer.
Requires authentication
This also stops the currently running timer if there is one.
See Display the specified time entry. for the returned attributes.
Example request:
curl -X POST \
"https://web.timingapp.com/api/v1/time-entries/start" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"start_date":"2019-01-01T00:00:00+00:00","project":"Unproductive child project","title":"Client Meeting","notes":"Some more detailed notes"}'
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries/start"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
let body = {
"start_date": "2019-01-01T00:00:00+00:00",
"project": "Unproductive child project",
"title": "Client Meeting",
"notes": "Some more detailed notes"
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (201):
{
"data": {
"self": "\/time-entries\/2",
"start_date": "2019-01-01T00:00:00.000000+00:00",
"end_date": "2019-01-01T00:00:00.000000+00:00",
"duration": 0,
"project": {
"self": "\/projects\/2"
},
"title": "Client Meeting",
"notes": "Some more detailed notes",
"is_running": true,
"creator_name": "Johnny Appleseed"
},
"message": "Timer 'Client Meeting' started."
}
HTTP Request
POST api/v1/time-entries/start
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
start_date |
date | optional | The date this timer should have started at. Defaults to "now". Example: |
project |
project | optional | The project this timer is associated with. Can be a project reference in the form "/projects/1" , a project title (e.g. "Project at root level" ), or an array with the project's entire title chain (e.g. ["Project at root level", "Unproductive child project"] ). |
title |
string | optional | The timer's title. |
notes |
string | optional | The timer's notes. |
Stop the currently running timer.
Requires authentication
Returns the stopped timer's attributes as listed under Display the specified time entry..
Example request:
curl -X PUT \
"https://web.timingapp.com/api/v1/time-entries/stop" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries/stop"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "PUT",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": {
"self": "\/time-entries\/1",
"start_date": "2019-01-01T00:00:00.000000+00:00",
"end_date": "2019-01-01T01:00:00.000000+00:00",
"duration": 3600,
"project": {
"self": "\/projects\/1"
},
"title": "Client Meeting",
"notes": "Some more detailed notes",
"is_running": false,
"creator_name": "Johnny Appleseed"
},
"message": "Timer 'Client Meeting' stopped."
}
HTTP Request
PUT api/v1/time-entries/stop
Return a list of time entries.
Requires authentication
See Display the specified time entry. for the returned attributes.
Items are ordered descending by their start_date
field.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/time-entries?start_date_min=2019-01-01T00%3A00%3A00%2B00%3A00&start_date_max=2019-01-01T23%3A59%3A59%2B00%3A00&projects%5B%5D=%2Fprojects%2F1&include_child_projects=true&search_query=meeting&is_running=false&include_project_data=true&include_team_members=false&team_members%5B%5D=%2Fusers%2F1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries"
);
let params = {
"start_date_min": "2019-01-01T00:00:00+00:00",
"start_date_max": "2019-01-01T23:59:59+00:00",
"projects[]": "/projects/1",
"include_child_projects": "true",
"search_query": "meeting",
"is_running": "false",
"include_project_data": "true",
"include_team_members": "false",
"team_members[]": "/users/1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": [
{
"self": "\/time-entries\/1",
"start_date": "2019-01-01T00:00:00.000000+00:00",
"end_date": "2019-01-01T01:00:00.000000+00:00",
"duration": 3600,
"project": {
"self": "\/projects\/1",
"team_id": null,
"title": "Project at root level",
"title_chain": [
"Project at root level"
],
"color": "#FF0000",
"productivity_score": 1,
"is_archived": false,
"parent": null
},
"title": "Client Meeting",
"notes": "Some more detailed notes",
"is_running": false,
"creator_name": "Johnny Appleseed"
}
],
"links": {
"first": "https:\/\/web.timingapp.com\/api\/v1\/time-entries?start_date_min=2019-01-01T00%3A00%3A00%2B00%3A00&start_date_max=2019-01-01T23%3A59%3A59%2B00%3A00&projects%5B%5D=%2Fprojects%2F1&include_child_projects=true&search_query=meeting&is_running=false&include_project_data=true&include_team_members=false&team_members%5B%5D=%2Fusers%2F1&page=1",
"last": "https:\/\/web.timingapp.com\/api\/v1\/time-entries?start_date_min=2019-01-01T00%3A00%3A00%2B00%3A00&start_date_max=2019-01-01T23%3A59%3A59%2B00%3A00&projects%5B%5D=%2Fprojects%2F1&include_child_projects=true&search_query=meeting&is_running=false&include_project_data=true&include_team_members=false&team_members%5B%5D=%2Fusers%2F1&page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https:\/\/web.timingapp.com\/api\/v1\/time-entries?start_date_min=2019-01-01T00%3A00%3A00%2B00%3A00&start_date_max=2019-01-01T23%3A59%3A59%2B00%3A00&projects%5B%5D=%2Fprojects%2F1&include_child_projects=true&search_query=meeting&is_running=false&include_project_data=true&include_team_members=false&team_members%5B%5D=%2Fusers%2F1&page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "https:\/\/web.timingapp.com\/api\/v1\/time-entries",
"per_page": 1000,
"to": 1,
"total": 1
}
}
HTTP Request
GET api/v1/time-entries
Query Parameters
Parameter | Status | Description |
---|---|---|
start_date_min |
optional | Restricts the query to time entries whose start date is equal to or later than this parameter. |
start_date_max |
optional | Restricts the query to time entries whose start date is equal to or earlier than this parameter. |
projects[] |
optional | Restricts the query to time entries associated with the given project. Can be repeated to include time entries from several projects. If you would like to include time entries that are not assigned to any project, you can provide an empty string, i.e. projects[]= |
include_child_projects |
optional | If true, the response will also contain time entries that belong to any child projects of the ones provided in projects[] . |
search_query |
optional | Restricts the query to time entries whose title and/or notes contain all words in this parameter. The search is case-insensitive but diacritic-sensitive. |
is_running |
optional | If provided, returns only time entries that are either running or not running. |
include_project_data |
optional | If true, the properties of the time entry's project will be included in the response. |
include_team_members |
optional | If true, the response will also contain time entries that belong to other team members, provided the current user has permission to view them. |
team_members[] |
optional | Restricts the query to data associated with the given user. Can be repeated to include time entries from several users. |
Create a new time entry.
Requires authentication
See Display the specified time entry. for the returned attributes.
Example request:
curl -X POST \
"https://web.timingapp.com/api/v1/time-entries" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"start_date":"2019-01-01T00:00:00+00:00","end_date":"2019-01-01T01:00:00+00:00","project":"Unproductive child project","title":"Client Meeting","notes":"Some more detailed notes"}'
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
let body = {
"start_date": "2019-01-01T00:00:00+00:00",
"end_date": "2019-01-01T01:00:00+00:00",
"project": "Unproductive child project",
"title": "Client Meeting",
"notes": "Some more detailed notes"
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (201):
{
"data": {
"self": "\/time-entries\/2",
"start_date": "2019-01-01T00:00:00.000000+00:00",
"end_date": "2019-01-01T01:00:00.000000+00:00",
"duration": 3600,
"project": {
"self": "\/projects\/2"
},
"title": "Client Meeting",
"notes": "Some more detailed notes",
"is_running": false,
"creator_name": "Johnny Appleseed"
}
}
HTTP Request
POST api/v1/time-entries
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
start_date |
date | required | The time entry's start date and time. |
end_date |
date | required | The time entry's end date and time. |
project |
project | optional | The project this time entry is associated with. Can be a project reference in the form "/projects/1" , a project title (e.g. "Project at root level" ), or an array with the project's entire title chain (e.g. ["Project at root level", "Unproductive child project"] ). |
title |
string | optional | The time entry's title. |
notes |
string | optional | The time entry's notes. |
Display the specified time entry.
Requires authentication
The following attributes will be returned:
self
: A link to the entity itself, relative to the API root.start_date
: The time entry's start date and time.end_date
: The time entry's end date and time.duration
: The time entry's total duration, in seconds.project
: The project this time entry is associated with.title
: The time entry's title.notes
: The time entry's notes.is_running
: Whether the time entry is currently running. Only one time entry can be running at any given time.
Example request:
curl -X GET \
-G "https://web.timingapp.com/api/v1/time-entries/1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries/1"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": {
"self": "\/time-entries\/1",
"start_date": "2019-01-01T00:00:00.000000+00:00",
"end_date": "2019-01-01T01:00:00.000000+00:00",
"duration": 3600,
"project": {
"self": "\/projects\/1"
},
"title": "Client Meeting",
"notes": "Some more detailed notes",
"is_running": false,
"creator_name": "Johnny Appleseed"
}
}
HTTP Request
GET api/v1/time-entries/{activity}
Update the specified time entry.
Requires authentication
See Display the specified time entry. for the returned attributes.
Example request:
curl -X PUT \
"https://web.timingapp.com/api/v1/time-entries/1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"start_date":"2019-01-01T00:00:00+00:00","end_date":"2019-01-01T01:00:00+00:00","project":"Unproductive child project","title":"Client Meeting","notes":"Some more detailed notes"}'
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries/1"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
let body = {
"start_date": "2019-01-01T00:00:00+00:00",
"end_date": "2019-01-01T01:00:00+00:00",
"project": "Unproductive child project",
"title": "Client Meeting",
"notes": "Some more detailed notes"
}
fetch(url, {
method: "PUT",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"data": {
"self": "\/time-entries\/1",
"start_date": "2019-01-01T00:00:00.000000+00:00",
"end_date": "2019-01-01T01:00:00.000000+00:00",
"duration": 3600,
"project": {
"self": "\/projects\/2"
},
"title": "Client Meeting",
"notes": "Some more detailed notes",
"is_running": false,
"creator_name": "Johnny Appleseed"
}
}
HTTP Request
PUT api/v1/time-entries/{activity}
PATCH api/v1/time-entries/{activity}
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
start_date |
date | optional | The time entry's start date and time. |
end_date |
date | optional | The time entry's start date and time. |
project |
project | optional | The project this time entry is associated with. Can be a project reference in the form "/projects/1" , a project title (e.g. "Project at root level" ), or an array with the project's entire title chain (e.g. ["Project at root level", "Unproductive child project"] ). |
title |
string | optional | The time entry's title. |
notes |
string | optional | The time entry's notes. |
Delete the specified time entry.
Requires authentication
Example request:
curl -X DELETE \
"https://web.timingapp.com/api/v1/time-entries/1" \
-H "Authorization: Bearer {{token}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json"
const url = new URL(
"https://web.timingapp.com/api/v1/time-entries/1"
);
let headers = {
"Authorization": "Bearer {{token}}",
"Accept": "application/json",
"Content-Type": "application/json",
};
fetch(url, {
method: "DELETE",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
HTTP Request
DELETE api/v1/time-entries/{activity}