{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"c297fd78-9e8e-483a-87ba-4e44ba6b37f2","name":"TrackingTime API","description":"The TrackingTime API allows you to integrate our features and your account data into your own applications.\n\n## Making a Request\n\nAll request URLs start with this base URL. Requests must be sent via SSL. The path is prefixed with the API version. If we change the API in backward-incompatible ways, we'll bump the version marker and maintain stable support for the old URLs.\n\n[<b>https://api.trackingtime.co/api/v4</b>](https://api.trackingtime.co/api/v4)\n\nFor instance, to list all your workspace users, you'd append the users' endpoint path to the base url to get this:\n\n[<b>https://api.trackingtime.co/api/v4/users</b>](https://api.trackingtime.co/api/v4/users)\n\nIn case you belong to multiple workspaces, you will need to append the account id of the workspace you'd like to use as follows. If you don't specify an account id, the id of your default account will be used.\n\n[<b>https://api.trackingtime.co/api/v4/:account_id/:endpoint_path</b>](https://api.trackingtime.co/api/v4/:account_id/:endpoint_path), e.g.\n\n[<b>https://api.trackingtime.co/api/v4/12345/users</b>](https://api.trackingtime.co/api/v4/12345/users)\n\n> You can find your account id by sending a request to the login endpoint. \n  \n\n## Authentication\n\nTo hit the ground running with the API, you can use [HTTP Basic Authentication](http://en.wikipedia.org/wiki/Basic_access_authentication) with your own email and password. This is secure since all requests use SSL.\n\nInstead of using your personal password, you can also work with [App Passwords](https://support.trackingtime.co/en/articles/6329119-auth#h_2186c8e7c7), which are more flexible and allow you to use different passwords for different integrations you build.\n\n```\ncurl --location --request GET 'https://api.trackingtime.co/api/v4/1725/customers/372222?include_custom_fields=true' \\\n--header 'Authorization: {{vault:basic-auth}}'\n\n ```\n\n### Supplying basic auth headers\n\nYou need to construct and send basic auth headers with your requests, specifying your email (username) and password. To do this you need to perform the following steps:\n\n1. Build a string of the form email:password, e.g. \"[john@doe.com](https://mailto:john@doe.com):MyPassWord\".\n    \n2. BASE64 encode that string.\n    \n3. Supply an Authorization header with content \"Basic\" followed by the encoded string. For example, the string \"[john@doe.com](https://mailto:john@doe.com):MyPassWord\" encodes to ImpvaG5AZG9lLmNvbTpNeVBhc3NXb3JkIg== in Base64, so you would make the request as follows:\n    \n\n```\ncurl -D- \\\n   -X GET \\\n   -H \"Authorization: {{vault:basic-auth}}\" \\\n   -H \"Content-Type: application/json\" \\\n   \"https://api.trackingtime.co/api/v4/users\"\n\n ```\n\n## Identifying your App\n\nYour requests must include a User-Agent header with the name of your application and a link to your website or your email address so that we can reach out to you. You might also want to include your app's version.\n\n```\nUser-Agent: 'MyApp, Inc. (http://myapp.com/contact)'\nUser-Agent: 'MyApp v1.2 (email@yourapp.com)'\ncurl -u username:password -H User-Agent: 'MyApp (yourname@example.com)' https://app.trackingtime.co/api/v4/tasks\n\n ```\n\n## Request Format\n\nFor `POST` endpoints, TrackingTime supports multiple input formats depending on your client or integration needs:\n\n- Standard form parameters\n    \n- Raw JSON request bodies\n    \n- Gzip-compressed request bodies\n    \n\n### Form Parameters\n\nYou can send parameters as regular form fields, including `application/x-www-form-urlencoded` and `multipart/form-data`.\n\n### Raw JSON\n\nYou can also send request data as a raw JSON body.\n\nExample:\n\n``` json\n{\n  \"user_id\": 12345,\n  \"task_id\": 67890,\n  \"start\": \"2025-01-10 09:00:00\",\n  \"end\": \"2025-01-10 11:00:00\",\n  \"notes\": \"Worked on bug fixes\",\n  \"timezone\": \"America/Argentina/Buenos_Aires\"\n}\n\n ```\n\n### Gzip\n\nFor clients that need compressed payloads, TrackingTime also accepts gzip-compressed request bodies when the appropriate Content-Encoding: gzip header is included.\n\nThis is useful for larger payloads or integrations that optimize network usage.\n\n## Standard JSON Response\n\nAll API endpoints return a JSON object with the following format:\n\n``` json\n{\n    \"response\": {\n        \"status\": 200,\n        \"version\": \"4.0\",\n        \"message\": \"ok\",\n        \"note\": null,\n        \"note_type\": null\n    },\n    \"data\": {\n    }\n}\n\n ```\n\nThese are the standard response parameters for all API calls.\n\n- **version**: The API version that handled the request.\n    \n- **status**: The HTTP response status code.\n    \n- **message**: The server response message, if any.\n    \n- **notes**: Contains additional information for the end user.\n    \n- **note_type**: Used to identify the type of note that should be shown to the user. \\[INFO | WARNING | ERROR | ALERT\\]\n    \n\nIn case an error occurs, the response status will be set to 500 and you'll get an error description in the response message. Callers should always check the value of the status parameter in the response.\n\n``` json\n{\n    \"response\": {\n        \"status\": 500,\n        \"version\": \"4.0\",\n        \"note\": null,\n        \"note_type\": null,\n        \"message\": \"There is already another customer with that name. Please choose a different one.\"\n    },\n    \"data\": {\n    }\n}\n\n ```\n\n© 2012-2026 TRACKING TIME, LLC. All rights reserved. [Contact Us](https://mailto:support@trackingtime.co)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"25701910","team":629555,"collectionId":"c297fd78-9e8e-483a-87ba-4e44ba6b37f2","publishedId":"2s935snMYt","public":true,"publicUrl":"https://developers.trackingtime.co","privateUrl":"https://go.postman.co/documentation/25701910-c297fd78-9e8e-483a-87ba-4e44ba6b37f2","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"ED565A"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2023-03-16T13:08:55.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"Production","id":"97191acc-43aa-4424-a319-1b183757fe8e","owner":"828065","values":[{"key":"api_url","value":"https://api.trackingtime.co/api/v4","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/c4fca51bc6a6482ea425ff7871b72070997de0ba559c56eed47e32ae40871a1e","favicon":"https://res.cloudinary.com/postman/image/upload/v1680095473/team/lxjp3ybqugb4fi2tqhnd.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"828065-97191acc-43aa-4424-a319-1b183757fe8e"}],"canonicalUrl":"https://developers.trackingtime.co/view/metadata/2s935snMYt"}