{"id":23846,"date":"2025-06-27T08:52:14","date_gmt":"2025-06-27T08:52:14","guid":{"rendered":"https:\/\/clockify.me\/help\/?p=23846"},"modified":"2026-01-16T13:38:19","modified_gmt":"2026-01-16T13:38:19","slug":"common-errors-and-issues","status":"publish","type":"post","link":"https:\/\/clockify.me\/help\/troubleshooting\/general-api-troubleshooting\/common-errors-and-issues","title":{"rendered":"Common errors and issues"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Start time is greater than end time\u00a0<\/h2>\n\n\n\n<p>This error occurs when the start time in your API request is after the end time, often due to a mismatch between local time zones and UTC, which is what the Clockify API expects.&nbsp;<\/p>\n\n\n\n<p>Why this happens:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The Clockify API uses UTC time for all time-based values<\/li>\n\n\n\n<li>Sending a start time in local time (e.g., Brussels +1) without converting it to UTC may result in a start time that appears later than the end time.\u00a0<\/li>\n<\/ul>\n\n\n\n<p>How to fix it:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Make sure both start and end times in your request are converted to UTC.<\/li>\n\n\n\n<li>Double-check the full API request:\n<ul class=\"wp-block-list\">\n<li>Endpoint used<\/li>\n\n\n\n<li>Request body and time fields<\/li>\n\n\n\n<li>Headers (especially Content-Type and authentication)<\/li>\n\n\n\n<li>Time zone settings on the server or script generating the request<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p class=\"note\">Even if a non-UTC start time is accepted, the timer might begin with a negative duration, which can affect calculations and reporting. Converting to UTC resolves this issue completely.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">403 &#8211; Forbidden<\/h2>\n\n\n\n<p>This error means your request is understood by the server, but you\u2019re not authorized to perform the action due to missing permissions or feature restrictions.&nbsp;<\/p>\n\n\n\n<p>Why this happens:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The API key being used doesn\u2019t have permission for the requested operation<\/li>\n\n\n\n<li>The user\u2019s role (e.g., Project Manager or a Team Manager) has limited access<\/li>\n\n\n\n<li>The subscription plan doesn\u2019t include the requested feature<\/li>\n\n\n\n<li>You\u2019re requesting a report with amounts, but you don\u2019t have permission to view amounts<\/li>\n<\/ul>\n\n\n\n<p>How to fix it:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check user role and permissions:<\/li>\n<\/ul>\n\n\n\n<p>Make sure the API key belongs to a user with the correct role and access to the resource.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verify subscription:<\/li>\n<\/ul>\n\n\n\n<p>Some endpoints and features require a paid plan, like \u201cAdd time for others\u201d, for example.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Regenerate your API key:<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click on your Profile picture and select Preferences<\/li>\n\n\n\n<li>Open the Advanced tab<\/li>\n\n\n\n<li>Click Generate next to the API key field<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If generating a report as a Project or a Team Manager:<\/li>\n<\/ul>\n\n\n\n<p>If amounts are restricted and you don\u2019t have access, use the following parameter in your request:<\/p>\n\n\n\n<p>\u201camountShown\u201d: \u201cHIDE_AMOUNT\u201d<\/p>\n\n\n\n<p>This will generate the report without including financial data.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">401 &#8211; Unauthorized<\/h2>\n\n\n\n<p>This error means authentication failed, usually because the API key is missing, invalid, or not authorized to access the requested source.&nbsp;<\/p>\n\n\n\n<p>Why this happens:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>API key is missing, invalid, or incorrectly passed in the header<\/li>\n\n\n\n<li>API key is associated with a user who doesn\u2019t have access to the endpoint<\/li>\n\n\n\n<li>The current subscription plan doesn\u2019t support the requested feature<\/li>\n<\/ul>\n\n\n\n<p>How to fix it:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verify that the API key is included correctly<\/li>\n<\/ul>\n\n\n\n<p>X-Api-Key: your_api_key<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check that the API key is valid:<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click on your profile picture and select Preferences\u00a0<\/li>\n\n\n\n<li>Open the Advanced tab<\/li>\n\n\n\n<li>Click Generate to create a new API key<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ensure correct permissions\u00a0<\/li>\n<\/ul>\n\n\n\n<p>The user tied to the API key must have access to the requested workspace, project, or feature.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Double-check your plan:<\/li>\n<\/ul>\n\n\n\n<p>Some API endpoints are only available on paid plans, like \u201cAdd time for others\u201d, for example.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">400 &#8211; Required token or API key and 1000 &#8211; Full authentication required<\/h2>\n\n\n\n<p>This error appears when the request is missing an authentication header, meaning the system doesn\u2019t know who is making the request.<\/p>\n\n\n\n<p>Why this happens:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The API call is missing the X-Api-Key in the headers<\/li>\n\n\n\n<li>The request might be sent from a script or tool that didn\u2019t properly include authentication info<\/li>\n<\/ul>\n\n\n\n<p>How to fix it:<\/p>\n\n\n\n<p>Include the following header in your request:<\/p>\n\n\n\n<p>X-Api-Key: your_api_key&nbsp;<\/p>\n\n\n\n<p>Still having issues? The Clockify Support Team will be happy to look into it and assist you further. Please contact us at support@clockify.me and include the following details:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>A screenshot of the request and response you\u2019re getting\u00a0<\/li>\n\n\n\n<li>Information about your role in the workspace\u00a0<\/li>\n\n\n\n<li>A screenshot of the error message you see in the response<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"Start time is greater than end time\u00a0 This error occurs when the start time in y&#8230;","protected":false},"author":41,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[73],"tags":[],"class_list":["post-23846","post","type-post","status-publish","format-standard","hentry","category-general-api-troubleshooting"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"Milena Dimic Vlajic","author_link":"https:\/\/clockify.me\/help\/author\/millenaclockify-me"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/posts\/23846","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/users\/41"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/comments?post=23846"}],"version-history":[{"count":2,"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/posts\/23846\/revisions"}],"predecessor-version":[{"id":23848,"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/posts\/23846\/revisions\/23848"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/media?parent=23846"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/categories?post=23846"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/wp-json\/wp\/v2\/tags?post=23846"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}