Get staff information
\<font color="#2166ae">get\</font> /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 \<font color="#00a2e9">query parameters\</font> customer id \<font color="#a7b4c3">string required\</font> the unique marco identifier for your company customer system id \<font color="#a7b4c3">array\[string] required\</font> the staff's user ids in your company's system example \[49,50] customer system id type \<font color="#a7b4c3">string required\</font> 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 \<font color="#a7b4c3">string\</font> the staff's full name role \<font color="#a7b4c3">string\</font> the staff's role in marco valid values staff, manager, manager & staff, intern system email \<font color="#a7b4c3">string\</font> the staff's email, used to log into marco id \<font color="#a7b4c3">integer\</font> the staff's unique identifier in marco country \<font color="#a7b4c3">string\</font> the staff's current country, stored as an iso alpha 2 code https //www iban com/country codes status \<font color="#a7b4c3">string\</font> the staff's job status valid values inactive, onboarding, probation, regular, offboarded offboarding reason \<font color="#a7b4c3">string\</font> the staff's offboarding reason valid values involuntary, voluntary {address} \<font color="#a7b4c3">object\</font> the staff's home address {address} city \<font color="#a7b4c3">string\</font> the city name for the staff's home address {address} address1 \<font color="#a7b4c3">string\</font> the first address line for the staff's home address {address} address2 \<font color="#a7b4c3">string\</font> the second address line for the staff's home address {address} address3 \<font color="#a7b4c3">string\</font> the third address line for the staff's home address birthdate \<font color="#a7b4c3">string\</font> the staff's date of birth, stored as yyyy mm dd gender \<font color="#a7b4c3">string\</font> the staff's gender highest education \<font color="#a7b4c3">string\</font> the staff's highest education nationality \<font color="#a7b4c3">string\</font> the staff's nationality, stored as the country's iso alpha 2 code https //www iban com/country codes personal email \<font color="#a7b4c3">string\</font> the staff's personal email phone \<font color="#a7b4c3">string\</font> the staff's phone number emergency name \<font color="#a7b4c3">string\</font> the name of the staff's emergency contact emergency email \<font color="#a7b4c3">string\</font> the email belonging to the staff's emergency contact emergency phone \<font color="#a7b4c3">string\</font> the phone number belonging to the staff's emergency contact emergency relationship \<font color="#a7b4c3">string\</font> the staff's relationship to the emergency contact passport number \<font color="#a7b4c3">string\</font> the staff's passport number passport issue date \<font color="#a7b4c3">string\</font> the staff's passport issue date passport issuing country \<font color="#a7b4c3">string\</font> the staff's passport issuing country, stored as an iso alpha 2 code https //www iban com/country codes passport expiry date \<font color="#a7b4c3">string\</font> the staff's passport expiry date reporting officer \<font color="#a7b4c3">string\</font> the staff's reporting manager job title \<font color="#a7b4c3">string\</font> the staff's job title location \<font color="#a7b4c3">string\</font> the staff's work location staff type \<font color="#a7b4c3">string\</font> the staff's service type valid values system, payroll, hro, eor work email \<font color="#a7b4c3">string\</font> the staff's work email ec entity \<font color="#a7b4c3">string\</font> the business entity that holds the employment relationship with the staff ec type \<font color="#a7b4c3">string\</font> the staff's employment contract type valid values fixed term, indefinite ec vendor \<font color="#a7b4c3">string\</font> the vendor that employs the staff applies to eor staff only job start date \<font color="#a7b4c3">string\</font> the staff's job start date probation end date \<font color="#a7b4c3">string\</font> the staff's probation end date ec start date \<font color="#a7b4c3">string\</font> 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 \<font color="#a7b4c3">string\</font> the end date for the staff's employment contract last working day \<font color="#a7b4c3">string\</font> the staff's last working day host country \<font color="#a7b4c3">string\</font> the staff's host country, stored as an iso alpha 2 code https //www iban com/country codes applies to expat staff only host staff type \<font color="#a7b4c3">string\</font> the staff's service type in the host country applies to expat staff only host ec entity \<font color="#a7b4c3">string\</font> the business entity that holds the employment relationship with the staff in the host country applies to expat staff only host ec vendor \<font color="#a7b4c3">string\</font> the vendor that employs the staff in the host country applies to eor expat staff only host ec type \<font color="#a7b4c3">string\</font> the staff's employment contract type in the host country applies to expat staff only valid values fixed term, indefinite host ec start date \<font color="#a7b4c3">string\</font> the start date for the staff's employment contract in the host country applies to expat staff only host ec end date \<font color="#a7b4c3">string\</font> the end date for the staff's employment contract in the host country applies to expat staff only job scope \<font color="#a7b4c3">string\</font> the job scope for the staff customer system id \<font color="#a7b4c3">string\</font> the staff's user id in your company's system