Getting startedGeneralCRMDealsInvoicesSubscriptionsProductsTicketsTimetracking & TasksCallsMeetingsPlanningProjectsExternal costsNotesFilesUsers & TeamsCustom Fields

Teamleader Planning API

This document assumes you have your API key and know how to perform a POST request (see Getting started)

This part of the api allows you to fetch information about planning from Teamleader.

Fetching information about planning

Fetching planned tasks in a certain time range

API endpoint: https://app.teamleader.eu/api/getPlannedTasks.php

Required POST parameters (NOTE: the maximum request period is one month)

  • date_from: date (dd/mm/yyyy): the start date of the period you are requesting planned tasks for
  • date_to: date (dd/mm/yyyy): the end date of the period you are requesting planned tasks for

Optional POST parameters (NOTE: use at least one filter)

  • user_id: ID: return only tasks planned for this user
  • project_id: ID: return only tasks planned for this project

Sample output

Example output: JSON array containing information about the planned task entries.
  • todo_id: id of the planned task
  • startdate: unix timestamp
  • startdate_formatted: dd/mm/yyyy
  • duration_minutes: integer
  • user_id: id of the responsible user
  • project_id: id of the related project

Getting information about company days off

API endpoint: https://app.teamleader.eu/api/getDaysOff.php

Required POST parameters

  • year: the year for which data should be returned

Sample output

Example output: JSON array containing the dates (dd/mm/yyyy) the company is closed and their id's.

Getting information about days off by user

API endpoint: https://app.teamleader.eu/api/getDaysOffByUser.php

Required POST parameters

  • user_id: ID of the user your are requesting information about
  • year: the year for which data should be returned

Sample output

Example output: JSON array containing the dates this user will not come into work.
  • date: dd/mm/yyyy
  • duration_hours: integer
  • type: string
  • approved: string containing 'yes' or 'no'