CharlieHR API

12 endpoints for CharlieHR, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/charliehr
Connects with: Your own CharlieHR account (Super Admin or Admin for company-wide work, Line Manager or Team Lead for your own reports)
Integration page: CharlieHR

Read (5)

Return data and change nothing in the account.

CharlieHR Endpoints: Read
Endpoint	Description
GET /team-members	People in your CharlieHR account with office, team, line manager and start date.
GET /team-member	One profile: office, team, line manager, start date, role and working week.
GET /time-off-requests	Time off requests with person, type, dates, days and status.
GET /members/{member_id}/time-off-allowance	Allowance, days used, pending and remaining for one person and leave year, with adjustments.
GET /whos-working	Who is working where and who is off, for one day.

Change the account. Calls marked Confirm wait for the user to approve them.

CharlieHR Endpoints: Write
Endpoint	Description
POST /requests/{request_id}/time-off-request/approve Confirm	Approve one pending time off request, with an optional message to the person.
POST /requests/{request_id}/time-off-request/deny Confirm	Deny one pending time off request, with a message to the person.
POST /members/{member_id}/time-offs Confirm	Book time off on behalf of a team member; it is approved at once.
POST /members/{member_id}/sick-days Confirm	Record sick leave for a team member; it is approved at once.
POST /members/{member_id}/time-off-allowance/adjust Confirm	Add or remove days on one person's allowance, with a type, an expiry date and a note.
POST /bookings/{booking_id}/time-off-booking/cancel Confirm	Cancel one upcoming or past time off booking.
POST /members/{member_id}/team-member/offboard Confirm	Offboard a person with a leaving date and a reason; the profile is archived.