Get time-off records for one staff

\get \ /api/ee time off gets time off records for one staff , using the user id in your system (external id) the information will be displayed in your language of choice request \query parameters\ lang \string required\ the language settings, formatted as an uppercase iso 639 1 code https //en wikipedia org/wiki/list of iso 639 1 codes the leave item information will be displayed in the selected language valid values en, zh customer id \integer required\ the unique marco identifier for your company customer system id \string required\ the staff's unique identifier in your company's system example 50 filter \string optional\ filter for deleted items marco retains deleted items in the system, and you can choose whether deleted items will be returned default {"is deleted"\ false} search start date \string optional\ start date for the date range filter, formatted as yyyy/mm/dd only time off records after the selected start date will be returned search end date \string \ \optional\ end date for the date range filter, formatted as yyyy/mm/dd only time off records before the selected end date will be returned example requests curl 'https //api marcopayroll com/api\ benkock8/api/ee time off?customer id=99\&lang=en\&customer system id=123\&filter={"is deleted"\ false}\&search start date=2023/01/01\&search end date=2023/12/31' \\ h 'authorization $auth token'import requests url = "https //api marcopayroll com/api\ benkock8/api/ee time off?customer id=99\&lang=en\&customer system id=123\&filter={"is deleted"\ false}\&search start date=2023/01/01\&search end date=2023/12/31" headers = { 'accept' 'application/json', 'authorization' 'your auth token' } response = requests get(url, headers=headers) print(response text)\[ { "id" 474, "customer id" 99, "approver" 0, "total days" 1, "start date" "2023 03 03", "end date" "2023 03 03", "notes" "", "reject notes" "", "decision time" null, "decision" "", "doc list" \[], "created at" 1679661912563, "updated at" 1679661912563, "deleted at" null, "created by" 0, "last modified by" 1348, "leave type" { "id" 12, "country" 15, "display order" 1, "day type" "", "minimum days" 0, "is annual leave" true, "created at" 1667530650560, "updated at" 1667530650560, "last modified by" 33, "deleted at" null, "leave type name" "annual leave", "leave type notes" "employees should be entitled 14 consecutive days during the subsequent 12 months " }, "user" { "id" 1348, "name" "mary jane", "email" "mary jane\@mail com", "pic" null, "customer system id" "123", "deleted at" null } }, { "id" 473, "customer id" 99, "approver" 1307, "total days" 2, "start date" "2023 03 01", "end date" "2023 03 02", "notes" "", "reject notes" "", "decision time" 1679690638000, "decision" "approve", "doc list" \[], "created at" 1679661838905, "updated at" 1679661838906, "deleted at" null, "created by" 0, "last modified by" 1307, "leave type" { "id" 12, "country" 15, "display order" 1, "day type" "", "minimum days" 0, "is annual leave" true, "created at" 1667530650560, "updated at" 1667530650560, "last modified by" 33, "deleted at" null, "leave type name" "annual leave", "leave type notes" "employees should be entitled 14 consecutive days during the subsequent 12 months " }, "user" { "id" 1348, "name" "mary jane", "email" "mary jane\@mail com", "pic" null, "customer system id" "123", "deleted at" null } }, { "id" 452, "customer id" 99, "approver" 0, "total days" 2, "start date" "2023 10 08", "end date" "2023 10 09", "notes" "", "reject notes" "", "decision time" 1678779083230, "decision" "", "doc list" \[], "created at" 1678779083232, "updated at" 1678779083232, "deleted at" null, "created by" 0, "last modified by" 1307, "leave type" { "id" 13, "country" 15, "display order" 2, "day type" "", "minimum days" 10, "is annual leave" false, "created at" 1667530650560, "updated at" 1667530650560, "last modified by" 33, "deleted at" null, "leave type name" "sick leave", "leave type notes" "employees are entitled to sick leave after 3 months of working " }, "user" { "id" 1348, "name" "mary jane", "email" "mary jane\@mail com", "pic" null, "customer system id" "123", "deleted at" null } }, { "id" 457, "customer id" 99, "approver" 654, "total days" 2, "start date" "2023 10 08", "end date" "2023 10 09", "notes" "", "reject notes" "please include details for the leave application", "decision time" 1678956394828, "decision" "reject", "doc list" \[], "created at" 1678956371624, "updated at" 1678956371624, "deleted at" null, "created by" 0, "last modified by" 654, "leave type" { "id" 12, "country" 15, "display order" 1, "day type" "", "minimum days" 0, "is annual leave" true, "created at" 1668493783625, "updated at" 1668493783625, "last modified by" 4, "deleted at" null, "leave type name" "annual leave", "leave type notes" "employees should be entitled 14 consecutive days during the subsequent 12 months " }, "user" { "id" 1348, "name" "mary jane", "email" "mary jane\@mail com", "pic" null, "customer system id" "123", "deleted at" null } }, { "id" 544, "customer id" 99, "approver" 0, "total days" 2, "start date" "2023 10 08", "end date" "2023 10 09", "notes" "", "reject notes" "", "decision time" 1685516501705, "decision" "", "doc list" \[], "created at" 1685516501707, "updated at" 1685516501707, "deleted at" null, "created by" 0, "last modified by" 1307, "leave type" { "id" 104, "country" 61, "display order" 1, "day type" "working", "minimum days" 7, "is annual leave" true, "created at" 1668493783625, "updated at" 1668493783625, "last modified by" 4, "deleted at" null, "leave type name" "annual leave", "leave type notes" "employees are entitled to minimum 7 days, with 1 additional day for each year " }, "user" { "id" 1348, "name" "mary jane", "email" "mary jane\@mail com", "pic" null, "customer system id" "123", "deleted at" null } } ] response (200) a successful response will return an array of objects each object contains one time off record for the staff id \integer\ the unique marco identifier for the staff's time off record customer id \integer\ the unique marco identifier for the staff's company approver \integer\ the u nique marco identifier for the user who approved the time off record total days \integer\ the number of leave days in the time off record start date \string\ the start date for the time off record , formatted as yyyy mm dd end date \string\ the end date for the time off record , formatted as yyyy mm dd notes \string\ the notes for the time off record typically contains the reason for the leave application reject notes \string\ the rejection notes for the time off record, if rejected decision time \string\ unix timestamp for the approval decision decision \string\ the approval decision valid values approve, reject doc list \array\[string]\ the supporting documents for the leave application created at \integer\ unix timestamp for the time off record's creation date updated at \integer\ unix timestamp for the time off record's update date deleted at \integer\ unix timestamp for the time off record's deletion date created by \integer\ the unique marco identifier for the user who created the time off record last modified by \integer\ the unique marco identifier for the user who last modified the time off record {leave type} \object\ the leave type metadata {leave type} id \integer\ the unique marco identifier for the leave type {leave type} country \integer\ the unique marco identifier for the leave type's associated country {leave type} display order \integer\ the display order for the leave type, when displayed in a list {leave type} day type \string\ the day type for the leave type valid values calendar, working {leave type} minimum days \integer\ minimum amount of days that should be granted to the staff {leave type} is annual leave \boolean\ whether the leave type is an annual leave {leave type} created at \integer\ unix timestamp for the leave type's creation date {leave type} updated at \integer\ unix timestamp for the leave type's update date {leave type} last modified by \integer\ the unique marco identifier for the user who last modified the leave type {leave type} deleted at \integer\ unix timestamp for the leave type's deletion date {leave type} leave type name \integer\ the leave type name example sick leave {leave type} leave type notes \string\ the notes for the leave type {user} \object\ the staff's details {user} id \integer\ the unique marco identifier for the staff {user} name \integer\ the staff's full name {user} email \integer\ the staff's email, used to log into marco {user} pic the staff's profile picture returned as a null value {user} customer system id \string\ the staff's unique identifier in your company's system example 50 {user} deleted at \integer\ unix timestamp for the time off record's deletion date