Planday Developer
Getting startedGuidesAPI
Visit our website
Getting started
Employee management integrationsPoint of Sale (POS) integrationsTime clock integrationsPayroll integrationsTime and Cost integrationsErrorsPlanday structure


Learn more about the error codes of the API and how you can handle them.

Http codeSample messageError explanation
400Employee id is invalidThe employeeId does not exist or the user is no longer active. Please verify the specified user.
401UnauthorizedThe app credentials are not sufficient. Please ensure to exchange the refresh token with and Access token or verify that the user who authorised the application is active.
403Your application isn't assigned to the appropriate scope, so it can't perform this actionPlease verify that your application has the right scopes in order to make this request.
404Employee with given id doesn't existThis user does not exist. Please verify employeeId and try again.
409ConflictA validation error occurred in your request data.
429Too many requestsYou’ve passed the rate limit for the allowed number of API requests.
500Server errorInternal server error - Please inform our API support team