API Reference
Staff
Get staff information
get get /api/staff info gets staff information using the user ids in your system (external id) you can retrieve information for a single staff or multiple staff request query parameters query parameters customer id string required string required the unique marco identifier for your company customer system id array\[string] required array\[string] required the staff's user ids in your company's system example \[49,50] customer system id type string required string required the name of your system example ps example requests curl 'https //api marcopayroll com/api\ benkock8/api/staff info?customer id=99\&customer system id=\[49,50]\&customer system id type=ps' \\ h 'authorization $auth token'import requests url = "https //api marcopayroll com/api/benkock8/api/staff info?customer id=99\&customer system id=\[49,50]\&customer system id type=ps" headers = { "accept" "application/json", "authorization" "your auth token" } response = requests get(url, headers=headers) print(response text)\[ { "name" "jane doe", "role" "staff", "system email" "jane doe\@mail com", "id" 1316, "country" "de", "status" "regular", "offboarding reason" "", "address" null, "birthdate" "", "gender" "", "highest education" "", "nationality" "", "personal email" "", "phone" "", "emergency name" "", "emergency email" "", "emergency phone" "", "emergency relationship" "", "passport number" "", "passpost issue date" "", "passport issuing country" "", "passport expiry date" "", "reporting officer" "jim joe", "job title" "sales manager", "location" "", "staff type" "system", "work email" "", "ec entity" "", "ec type" "", "ec vendor" "", "job start date" "2023 03 01", "probation end date" "2023 03 31", "ec start date" null, "ec end date" null, "last working day" null, "host country" "", "host staff type" "", "host ec entity" "", "host ec vendor" "", "host ec type" "", "host ec start date" "", "host ec end date" "", "job scope" "", "customer system id" "49", }, { "name" "li lei", "role" "staff", "system email" "lilei\@mail com", "id" 1348, "country" "cn", "status" "regular", "offboarding reason" "", "address" null, "birthdate" "", "gender" "male", "highest education" "university", "nationality" "cn", "personal email" "ll\@mail com", "phone" "8617623453456", "emergency name" "han meimei", "emergency email" "hmm\@mail com", "emergency phone" "8618876546789", "emergency relationship" "mother", "passport number" "eg8213789", "passpost issue date" "", "passport issuing country" "", "passport expiry date" "", "reporting officer" "tuan tuan", "job title" "product manager", "location" "beijing", "staff type" "payroll", "work email" "lilei\@mail com", "ec entity" "", "ec type" "fixed term", "ec vendor" "", "job start date" "2020 01 31", "probation end date" "2020 07 01", "ec start date" "2020 01 31", "ec end date" "2025 07 01", "last working day" null, "host country" "", "host staff type" "", "host ec entity" "", "host ec vendor" "", "host ec type" "", "host ec start date" "", "host ec end date" "", "job scope" "", "customer system id" "50", } ] response (200) a successful response will return an array of objects, with each object containing each staff's information name string string the staff's full name role string string the staff's role in marco valid values staff, manager, manager & staff, intern system email string string the staff's email, used to log into marco id integer integer the staff's unique identifier in marco country string string the staff's current country, stored as an iso alpha 2 code status string string the staff's job status valid values inactive, onboarding, probation, regular, offboarded offboarding reason string string the staff's offboarding reason valid values involuntary, voluntary {address} object object the staff's home address {address} city string string the city name for the staff's home address {address} address1 string string the first address line for the staff's home address {address} address2 string string the second address line for the staff's home address {address} address3 string string the third address line for the staff's home address birthdate string string the staff's date of birth, stored as yyyy mm dd gender string string the staff's gender highest education string string the staff's highest education nationality string string the staff's nationality, stored as the country's iso alpha 2 code personal email string string the staff's personal email phone string string the staff's phone number emergency name string string the name of the staff's emergency contact emergency email string string the email belonging to the staff's emergency contact emergency phone string string the phone number belonging to the staff's emergency contact emergency relationship string string the staff's relationship to the emergency contact passport number string string the staff's passport number passport issue date string string the staff's passport issue date passport issuing country string string the staff's passport issuing country, stored as an iso alpha 2 code passport expiry date string string the staff's passport expiry date reporting officer string string the staff's reporting manager job title string string the staff's job title location string string the staff's work location staff type string string the staff's service type valid values system, payroll, hro, eor work email string string the staff's work email ec entity string string the business entity that holds the employment relationship with the staff ec type string string the staff's employment contract type valid values fixed term, indefinite ec vendor string string the vendor that employs the staff applies to eor staff only job start date string string the staff's job start date probation end date string string the staff's probation end date ec start date string string the start date for the staff's employment contract this may differ from the job start date if multiple contracts have been signed in succession ec end date string string the end date for the staff's employment contract last working day string string the staff's last working day host country string string the staff's host country, stored as an iso alpha 2 code applies to expat staff only host staff type string string the staff's service type in the host country applies to expat staff only host ec entity string string the business entity that holds the employment relationship with the staff in the host country applies to expat staff only host ec vendor string string the vendor that employs the staff in the host country applies to eor expat staff only host ec type string string the staff's employment contract type in the host country applies to expat staff only valid values fixed term, indefinite host ec start date string string the start date for the staff's employment contract in the host country applies to expat staff only host ec end date string string the end date for the staff's employment contract in the host country applies to expat staff only job scope string string the job scope for the staff customer system id string string the staff's user id in your company's system