Employee Types API


Service Info

Endpoint URL: http://api.careerbuilder.com/v1/employeetypes

Default response format: XML

Employee types (sometimes called job types) are used in job searches to constrain results to a particular field or fields.

Since employee types vary from country to country, use the employee type service to view the list of available codes.

The request will return the employee type names in the language(s) supported by the country requested. The ISO language code will be listed in the "language" attribute of the Name node. A multilingual country will return at least two different names for each employee type.

Use caution when working with employee types, as we may change their values at any time.

GET requests only.

Parameters

All input parameters must be URL encoded.
v1/employeetypes parameters
Parameter name Required? XSD type Notes
DeveloperKey Yes string 20 character long CB API Developer Key.
CountryCode No string Accepts a single value only. Supported codes: AH, B1, B2, B3, B4, BE, C1, CA, CC, CE, CH, CN, CP, CS, CY, DE, DK, E1, ER, ES, EU, F1, FR, GC, GR, I1, IE, IN, IT, J1, JC, JS, LJ, M1, MC, MY, NL, NO, O1, OG, PD, PI, PL, RM, RO, RX, S1, SE, SF, SG, T1, T2, T3, UK, US, WH, WM, WR. Missing or Unsupported Codes Default to: US

Sample Output

<?xml version="1.0" encoding="UTF-8"?>
<ResponseEmployeeTypes>
    <Errors />
    <CountryCode>NL</CountryCode>
    <TimeResponseSent>5/12/2008 10:45:46 PM</TimeResponseSent>
    <EmployeeTypes>
        <EmployeeType>
            <Code>JTFT</Code>
            <Name language="nl">Fulltime werknemer</Name>
        </EmployeeType>
        <EmployeeType>
            <Code>JTPT</Code>
            <Name language="nl">Parttime werknemer</Name>
        </EmployeeType>
        <EmployeeType>
            <Code>JTFP</Code>
            <Name language="nl">Fulltime/parttime werknemer</Name>
        </EmployeeType>
        <EmployeeType>
            <Code>JTCT</Code>
            <Name language="nl">Contractant</Name>
        </EmployeeType>
        <EmployeeType>
            <Code>JTIN</Code>
            <Name language="nl">Stagiair</Name>
        </EmployeeType>
    </EmployeeTypes>
</ResponseEmployeeTypes>