To access any of the dictionary values you must first authenticate yourself as described in “Authenticating to Retrieve Dictionary Values“.

Retrieving Sectors and Sub Sectors

To retrieve a list of sectors and the associating sub sectors, send an authorised HTTP GET
request to the following URL:

GET https://core.ws.efinancialcareers.com/v1/sectors?locale=en

Mandatory HTTP headers

Content-Type: application/xml

Authorization: EfcAuth realm=”EFC”, token=”522c3c4bd036a69db428ce4274745e9d”

Here is an excerpt of the response:

Please note:

  1. sector / sectorCode = This is the constant we require the job XML to contain.
  2. labelTranslations / translation / content = This is the human-readable value.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:sectors xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
<ns2:sector>
<ns2:sectorCode>ACCOUNTING_FINANCE</ns2:sectorCode>
<ns2:subSectors>
<ns2:subSector>
<ns2:subSectorCode>ACCOUNTING_FINANCE__AUDIT</ns2:subSectorCode>
</ns2:subSector>
<ns2:subSector>
<ns2:subSectorCode>ACCOUNTING_FINANCE__FD_CFO</ns2:subSectorCode>
</ns2:subSector>
...........
</ns2:subSectors>
</ns2:sector>
<ns2:sector>
<ns2:sectorCode>ASSET_MANAGEMENT</ns2:sectorCode>
<ns2:subSectors>
<ns2:subSector>
<ns2:subSectorCode>ASSET_MANAGEMENT__ANALYST</ns2:subSectorCode>
</ns2:subSector>
<ns2:subSector>
<ns2:subSectorCode>ASSET_MANAGEMENT__CIO</ns2:subSectorCode>
</ns2:subSector>
............
</ns2:subSectors>
</ns2:sector>
<ns2:labelTranslations>
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.sector.dict.ACCOUNTING_FINANCE</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>Accounting & Finance</ns2:content>
</ns2:translation>
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.sector.dict.ASSET_MANAGEMENT</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>Asset Management</ns2:content>
</ns2:translation>
</ns2:labelTranslations>
</ns2:sectors>

Retrieving Position Types

To retrieve a list of position types, send an authorised HTTP GET request to the following URL:

GET https://core.ws.efinancialcareers.com/v1/dictionaries/positionType?locale=en

Mandatory HTTP headers

Here is an excerpt of the response:

Please note:

  1. positionTypes / positionType / dictionaryCode = This is the constant we require the job XML to contain.
  2. positionTypes / labelTranslations / translation / content = This is the human-readable value.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:positionTypes xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
<ns2:positionType>
<ns2:id>3</ns2:id>
<ns2:dictionaryCode>CONTRACT</ns2:dictionaryCode>
</ns2:positionType>
<ns2:positionType>
<ns2:id>5</ns2:id>
..........
<ns2:labelTranslations>
<ns2:type>dict</ns2:type>
<ns2:path>ws.positionType.dict.CONTRACT</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>Contract</ns2:content>
</ns2:translation>
</ns2:labelTranslations>
...........
</ns2:positionTypes>

Retrieving Employment Types

To retrieve a list of employment types, send an authorised HTTP GET request to the following URL:

GET https://core.ws.efinancialcareers.com/v1/dictionaries/employmentType?locale=en

Mandatory HTTP headers

Content-Type: application/xml

Authorization: EfcAuth realm=”EFC”, token=”522c3c4bd036a69db428ce4274745e9d”

Here is an excerpt of the response:

Please note:

  1. employmentTypes / employmentType / dictionaryCode = This is the constant we require the job XML to contain.
  2. employmentTypes / labelTranslations / translation / content = This is the human-readable value.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:employmentTypes xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
<ns2:employmentType>
<ns2:id>1</ns2:id>
<ns2:dictionaryCode>FULL_TIME</ns2:dictionaryCode>
</ns2:employmentType>
.........
<ns2:labelTranslations>
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.employmentType.dict.FULL_TIME</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>Full time</ns2:content>
</ns2:translation>
..........
</ns2:labelTranslations>
</ns2:employmentTypes>

Retrieving Salary Bands

To retrieve a list of salary bands, send an authorised HTTP GET request to the following URL:

GET https://core.ws.efinancialcareers.com/v1/dictionaries/salaryBand?locale=en

Mandatory HTTP headers

Content-Type: application/xml

Authorization: EfcAuth realm=”EFC”, token=”522c3c4bd036a69db428ce4274745e9d”

Here is an excerpt of the response:

Please note:

  1. salaryBands / salaryBand / dictionaryCode = This is the constant we require the job XML to contain.
  2. salaryBands / labelTranslations / translation / content = This is the human-readable value.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:salaryBands xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
<ns2:salaryBand>
<ns2:dictionaryCode>FIRST_TIER</ns2:dictionaryCode>
</ns2:salaryBand>
..........
<ns2:salaryBand>
<ns2:dictionaryCode>SEVENTH_TIER</ns2:dictionaryCode>
</ns2:salaryBand>
<ns2:translations>
<ns2:translation>
<ns2:path>ws.salaryBand.dict.FIRST_TIER</ns2:path>
<ns2:content currency="AED">0 - 40,000</ns2:content>
..........
<ns2:content currency="ZAR">0 - 200,000</ns2:content>
</ns2:translation>
..........
<ns2:translation>
<ns2:path>ws.salaryBand.dict.SEVENTH_TIER</ns2:path>
<ns2:content currency="RUB">2,160,000+</ns2:content>
</ns2:translation>
</ns2:translations>
</ns2:salaryBands>

Retrieving Currencies

To retrieve a list of currencies, send an authorised HTTP GET request to the following URL:

GET https://core.ws.efinancialcareers.com/v1/dictionaries/currencyType?locale=en

Mandatory HTTP headers

Content-Type: application/xml

Authorization: EfcAuth realm=”EFC”, token=”522c3c4bd036a69db428ce4274745e9d”

Here is an excerpt of the response:

Please note:

  1. currencyTypes / currencyType / dictionaryCode = This is the constant we require the job XML to contain.
  2. currencyTypes / labelTranslations / translation / content = This is the human-readable value.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:currencyTypes xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
<ns2:currencyType>
<ns2:id>16</ns2:id>
<ns2:dictionaryCode>AED</ns2:dictionaryCode>
</ns2:currencyType>
..........
<ns2:currencyType>
<ns2:id>15</ns2:id>
<ns2:dictionaryCode>ZAR</ns2:dictionaryCode>
</ns2:currencyType>
<ns2:labelTranslations>
..........
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.currencyType.dict.AED</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>UAE Dirham (AED)</ns2:content>
</ns2:translation>
...........
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.currencyType.dict.ZAR</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>Rand (ZAR)</ns2:content>
</ns2:translation>
</ns2:labelTranslations>
</ns2:currencyTypes>

Retrieving Job Application Methods

To retrieve a list of job application methods, send an authorised HTTP GET request to the following URL:

GET https://core.ws.efinancialcareers.com/v1/dictionaries/jobApplicationMethodType?locale=en

Mandatory HTTP headers

Content-Type: application/xml

Authorization: EfcAuth realm=”EFC”, token=”522c3c4bd036a69db428ce4274745e9d”

Here is an excerpt of the response:

Please note:

  1. jobApplicationMethodTypes / jobApplicationMethodType / dictionaryCode = This is the constant we require the job XML to contain.
  2. jobApplicationMethodTypes / labelTranslations / translation / content = This is the human-readable value.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:jobApplicationMethodTypes xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
<ns2:jobApplicationMethodType>
<ns2:id>2</ns2:id>
<ns2:dictionaryCode>BACK_OFFICE</ns2:dictionaryCode>
</ns2:jobApplicationMethodType>
..........
<ns2:jobApplicationMethodType>
<ns2:id>3</ns2:id>
<ns2:dictionaryCode>EXTERNAL_APPLICATION</ns2:dictionaryCode>
</ns2:jobApplicationMethodType>
<ns2:labelTranslations>
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.jobApplicationMethod.dict.BACK_OFFICE</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>All candidate applications go to our Back Office</ns2:content>
</ns2:translation>
..........
<ns2:translation>
<ns2:type>dict</ns2:type>
<ns2:path>ws.jobApplicationMethod.dict.EXTERNAL_APPLICATION</ns2:path>
<ns2:locale>en</ns2:locale>
<ns2:content>A candidate gets redirected to the external URL to apply for a job.</ns2:content>
</ns2:translation>
</ns2:labelTranslations>
</ns2:jobApplicationMethodTypes>

Retrieving Other Dictionary Values

Other dictionary requests are described in the table below:

Name

Request

Description

Years of Experience

https://core.ws.efinancialcareers.com/v1/dictionaries/yearsExperience

Valid Years of Experience Values

Education Levels

https://core.ws.efinancialcareers.com/v1/dictionaries/educationLevel

Valid Education Levels

Travel Rates

https://core.ws.efinancialcareers.com/v1/dictionaries/travelRate

Valid Travel Rates

Account Types

https://core.ws.efinancialcareers.com/v1/dictionaries/accountType

Valid Account Types

Company Types

https://core.ws.efinancialcareers.com/v1/dictionaries/companyType

Valid Company Types

Language Codes

https://core.ws.efinancialcareers.com/v1/dictionaries/languageCodes

Valid 2 symbols (6 for some languages) Language Codes with descriptions

Language Fluencies

https://core.ws.efinancialcareers.com/v1/dictionaries/languageFluency

Valid Levels of Language Fluency

Location Types

https://core.ws.efinancialcareers.com/v1/dictionaries/locationType

Valid Locations Types

Titles of Persons

https://core.ws.efinancialcareers.com/v1/dictionaries/title

Valid Titles of Persons

Resume License Types

https://core.ws.efinancialcareers.com/v1/dictionaries/resumeLicenseType

Valid Resume License Types

File Formats

https://core.ws.efinancialcareers.com/v1/dictionaries/fileFormat

Valid File Formats in the System, which can be used for File Uploading

Supported Locales

https://core.ws.efinancialcareers.com/v1/dictionaries/supportedLocales

Valid Locales in the System