Positions Resources

GetPositions

Description Returns list of positions for given seat; each position includes only basic description fields, other fields can be searched by GetPosition(); see result sample for full list of fields returned
Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

GetPositions(string authToken, string seatId): string

Parameters

authToken: authentication token that identifies partner application

seatId: id of a seat positions to be listed for

Result XML string

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

Result Sample

 



00000000-0000-0000-0000-000000000000
00000000-0000-0000-0000-000000000000
Position Title 1
[see [API Schema] for list of values]
[YYYY-MM-DDThh:mm:ssTZD (ISO8601)]
20
[YYYY-MM-DDThh:mm:ssTZD (ISO8601)]

GetPositionsByStatus

Description Returns list of positions for given seat, filtered by given status; each position includes only basic description fields, see result sample for full list of fields returned
Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

GetPositionsByStatus(string authToken, string seatId, string status): string

Parameters

authToken: authentication token that identifies partner application

seatId: id of a seat positions to be listed for

status: filter by status (see position schema for list of accepted values)

Result XML string

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Active

 

Result Sample

 



00000000-0000-0000-0000-000000000000
00000000-0000-0000-0000-000000000000
Position Title 1
Active
[YYYY-MM-DDThh:mm:ssTZD (ISO8601)]
20
[YYYY-MM-DDThh:mm:ssTZD (ISO8601)]

GetPosition

Description Returns full description of position by given ID; see position schema for details of fields returned
Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

GetPosition(string authToken, string positionId): string

Parameters

authToken: authentication token that identifies partner application

positionId: ID of position to be searched

Result XML string

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

Result Sample

 


00000000-0000-0000-0000-000000000000
00000000-0000-0000-0000-000000000000
Position Title 1
… see [API Schema] for full list of fields here …

GetAvailableCountries

Description Returns list of available countries that can be used for positions posted to the given seat
Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

GetAvailableCountries(string authToken, string seatId): string

Parameters

authToken: authentication token that identifies partner application

seatId: ID of a seat the list of available countries in which to be searched

Result XML string

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

Result Sample

 



00000000-0000-0000-0000-000000000000
Some country

Get AvailableStates

Description Returns list of available states that can be used for positions posted to the given country
Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

GetAvailableStates(string authToken, string countryId): string

Parameters

authToken: authentication token that identifies partner application

countryId: ID of a country the list of available states to be searched for

Result XML string

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

Result Sample

 



00000000-0000-0000-0000-000000000000
00000000-0000-0000-0000-000000000000

GetAvailableCategories

Description Returns list of available states that can be used for positions posted to the given country
Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

GetAvailableCategories(string authToken, string seatId): string

Parameters

authToken: authentication token that identifies partner application

seatId: ID of a seat the list of available position categories to be searched for

Result XML string

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

Result Sample

 



00000000-0000-0000-0000-000000000000
some name

AddPosition

Description

Adds a new position on behalf of the current partner authorized by auth token
Important! Adding position also adds search rule with the following default values:

  • maxSearchDurationMins = 60
  • maxResumesPerSource = 500
  • isActive = True
  • startDate = current date
  • withinDaysCount = 365
  • searchProvider =

    <searchProvider>
    <localSearch>
    <searchByDescription>False</searchByDescription>
    <searchByKeywords>False</searchByKeywords>
    </localSearch>
    <externalSearch>
    <searchInAllFreeSources>True</searchInAllFreeSources>
    <searchInSeatSources>
    <seatSource><id>[ANY]</id></seatSource>
    </searchInSeatSources>
    <webSearch>True</webSearch>
    </externalSearch>
    </searchProvider>

 

Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

AddPosition(string authToken, string positionXml): string

Parameters

authToken: authentication token that identifies partner application

positionXml: position details according to position schema

Result Full description XML of a position that was just created in the database; see position XML schema for field details

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX


XXX
YYY
… see [API Schema] for full list of fields here …


 

Result Sample

 


00000000-0000-0000-0000-000000000000
… see [API Schema] for full list of fields here …

UpdatePosition

Description

Updates the existing position on behalf of the current partner authorized by auth token; id of the position should exist in the database; all other fields will be overwritten

Entry Point https://www.talentfilter.biz/ws/positions.asmx
Method Signature

UpdatePosition(string authToken, string positionDescriptionXml): string

Parameters

authToken: authentication token that identifies partner application

positionXml: position details according to position schemapositionDescriptionXml: position details according to position schema; <id> is obligatory; the rest of the fields are optional, but at least one (except <id>) should be specified

Result Full description XML of a position that was just updated in the database; see position XML schema for field details

Samples

Request Sample

 

            
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX


00000000-0000-0000-0000-000000000000
XXX
YYY
… see [API Schema] for full list of fields here …


 

Result Sample

 


00000000-0000-0000-0000-000000000000
… see [API Schema] for full list of fields here …

Deleting Positions

Position deletion can be done via setting “delete” as position status in UpdatePosition().