« Back to SOAP operation list

findByListName

Retrieves the elements of a list of values. This values can be used for posting a job offer or retrieve the value of some CV fields. For example, you can get all the possible provinces, countries, industry type, etc.

Request

WSDL Production URL

https://api.infojobs.[net|it]/soap/WSListOfValuesService?wsdl

WSDL URL

https://api.infojobssbx.[net|it]/soap/WSListOfValuesService?wsdl

Security

  • User Role: PUBLIC

Parameters

Name Description

publicNameKey

String

Required

The name that identifies the list of values. You can see below the possible values.

Example values: PROVINCES

Available publicNameKey identifiers:
Name Description

CATEGORIES

Job industry used by employers to classify job vacancy. For example: Legal, Medical, Sales, Marketing...

COMOLASTJOB

Describes how the candidate found their last job.

COMUNITIES

Comunity name (Barcelona, Andalucia, Abroad, etc).

CONTRACTS

Type of contract between the employer and the employee (fixed-term, trainee, etc.).

COUNTRIES

Country of the job vacancy.

DAYS

Type of working day (full-time, part-time, etc.).

DETAILSTUDIES

Speciality of study, for example: Chemical Engineering, etc.

DISPONIBILITIES

Willingness to make a change (Bad, depends on the conditions, etc).

DOCUMENTTYPE

Type of document (nif, nie, passport)

DRIVINGLICENCES

Type of driving licenses

EMPLOYMENTSTATUS

The employment status of the candidate

EXPERIENCES

The number of years of experience of the candidate

FREEZONES

Array with the countries or regions where the candidate is allowed to work

INDUSTRIES

Business sector (art, architecture, etc).

LANGUAGES

Language names (English, Spanish, etc).

LABORALLEVEL

The Career level of the candidate. For example, Entry level, manager, etc.

MANAGERPROFESSIONALLEVEL

Text key that classifies the candidate's manager level for that experience, related to the role responsabiliy

MINEXPERIENCES

Minimum required experience to be considered for the job.

PERSONNELTOPOSITION

The number of persons in charge

PROVINCES

Province of the job vacancy. Related to parent grouping COUNTRIES.

READLEVEL

Level of proficiency for reading in a given language (Basic, Null, ...)

RESIDENTS

Candidate residence requirement (Province where the offer is posted, country where the offer is posted, not appliable, etc.)

SEXS

Gender

SKILLLEVEL

Level of expertise of the job seeker (High, Medium, ...).

SPOKENLEVEL

Level of proficiency for speaking a given language (Conversation, Null, ...)

STUDIESLEVEL

Level of education of the job seeker (Bachelor's degree, Masters, etc.).

SUBCATEGORIES

Subcategory used by employers to classify job vacancy. Related to the parent list CATEGORIES.

URLTYPE

The type of url provided (twitter, facebook, gitHub, ...)

WAGEAMOUNT

Monetary amount paid by the employer for a specified period.

WAGEPERIOD

Month, year, hour, week.

WRITTENLEVEL

Level of proficiency for writing in a given language (Conversation, Null, ...)

Response

Response entities

Returns a list with the values for the requested publicNameKey. For each item it returns the following fields:

Name Description

id

Identifier of the element.

valor

Human readable textual value.

order

Order of the element in the list.

Error codes

Code Description

WS.150

Expired access token

WS.152

Access Token is required

WS.153

Access token not authorized for this operation

WS.154

Invalid access token

WS.155

Invalid access token

WS.156

Wrong access token

WS.3000

Missing required parameter.

WS.3001

The parameter publicNameKey is not a valid list of values.

Examples

This example returns the list of values of Job industry using the publicNameKey: CATEGORIES

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:lis="http://listOfValues.service.ws.infojobs.net/">
    <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-799830164" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:Username>SOAP-TEST</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SOAP-TEST-SECRET</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
      <ij:authnHeader xmlns:ij='http://api.infojobs.net/soap/authn'>
        <token>20000000-0000-0000</token>
      </ij:authnHeader>
   </soapenv:Header>
   <soapenv:Body>
      <lis:findByListName>
         <publicNameKey>CATEGORIES</publicNameKey>
      </lis:findByListName>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <wsse:Security soap:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsu:Timestamp wsu:Id="TS-2">
            <wsu:Created>2012-05-07T08:08:22.555Z</wsu:Created>
            <wsu:Expires>2012-05-07T08:13:22.555Z</wsu:Expires>
         </wsu:Timestamp>
      </wsse:Security>
   </soap:Header>
   <soap:Body>
      <ns1:findByListNameResponse xmlns:ns1="http://listofvalues.endpoints.www.soap.infojobs.net/">
         <listOfValues>
            <items>
               <id>0</id>
               <orden>0</orden>
               <valor>(Seleccionar)</valor>
            </items>
            <items>
               <id>20</id>
               <orden>20</orden>
               <valor>Administración Pública</valor>
            </items>
            <items>
               <id>10</id>
               <orden>20</orden>
               <valor>Administración de empresas</valor>
            </items>
            <items>
               <id>170</id>
               <orden>20</orden>
               <valor>Atención a clientes</valor>
            </items>
            <items>
               <id>30</id>
               <orden>20</orden>
               <valor>Calidad, producción e I+D</valor>
            </items>
            <items>
               <id>190</id>
               <orden>20</orden>
               <valor>Comercial y ventas</valor>
            </items>
            <items>
               <id>40</id>
               <orden>20</orden>
               <valor>Compras, logística y almacén</valor>
            </items>
            <items>
               <id>50</id>
               <orden>20</orden>
               <valor>Diseño y artes gráficas</valor>
            </items>
            <items>
               <id>60</id>
               <orden>20</orden>
               <valor>Educación y formación</valor>
            </items>
            <items>
               <id>70</id>
               <orden>20</orden>
               <valor>Finanzas y banca</valor>
            </items>
            <items>
               <id>150</id>
               <orden>20</orden>
               <valor>Informática y telecomunicaciones</valor>
            </items>
            <items>
               <id>80</id>
               <orden>20</orden>
               <valor>Ingenieros y técnicos</valor>
            </items>
            <items>
               <id>90</id>
               <orden>20</orden>
               <valor>Inmobiliario y construcción</valor>
            </items>
            <items>
               <id>100</id>
               <orden>20</orden>
               <valor>Legal</valor>
            </items>
            <items>
               <id>110</id>
               <orden>20</orden>
               <valor>Marketing y comunicación</valor>
            </items>
            <items>
               <id>120</id>
               <orden>20</orden>
               <valor>Profesiones, artes y oficios</valor>
            </items>
            <items>
               <id>130</id>
               <orden>20</orden>
               <valor>Recursos humanos</valor>
            </items>
            <items>
               <id>140</id>
               <orden>20</orden>
               <valor>Sanidad y salud</valor>
            </items>
            <items>
               <id>160</id>
               <orden>20</orden>
               <valor>Turismo y restauración</valor>
            </items>
            <items>
               <id>200</id>
               <orden>20</orden>
               <valor>Ventas al detalle</valor>
            </items>
            <items>
               <id>180</id>
               <orden>30</orden>
               <valor>Otros</valor>
            </items>
         </listOfValues>
      </ns1:findByListNameResponse>
   </soap:Body>
</soap:Envelope>

Sections: