Position

Description

Position is a job opening client has and for which it wants to find resumes

API Schema

 

 

 

Required?

 

Field Name

Type

Description

ADD

UPD

Notes

id

String(50)

Unique ID

Ign.

Yes

 

seatId

String(50)

ID of a seat this position belongs to

+

 

 

 

 

 

 

 

 

 

 

 

 

 

At least one of these fields must be present

 

status

String(50)

Position status

+

Pending | Active | Complete | Disabled | Delete

title

String

(1024)

Position title

+

 

trackingId

String(255)

An optional tracking ID of position that may be used by clients as per their needs

-

API users may keep unique IDs from their systems in this field

countryId

String(50)

Unique ID of country the position to be searched in

-

See GetAvailableCountries() API function

stateId

String(50)

Unique ID of state the position to be searched in

-

See GetAvailableStates() API function

city

String(255)

City name the position to be searched in

-

 

zip

String(8)

Zip code the position to be searched around

-

 

radius

int

Distance in miles the position to be searched around specified zip-code

-

Zip is obligatory if this is specified

categoryId

String(50)

Unique ID of position category

-

See GetAvailableCategories() API function

description

text

Position description

+

Valid description is essential to receive relevant results

keywords

text

A special XML that describes position search keywords

-

See “<keywords>Schema” below

booleanKeywords text A special XML that describes position search Boolean keywords - See “<booleanKeywords>Schema” below
keywordsFieldUsed text Determines whether “booleanKeywords” or “keywords” field will be actually used -

One of:
    ·keywords
    ·booleanKeywords


If not specified, means “keywords”

educationReqs

int

Education requirements

-

    1 = Less than High School

    2 = High School

    3 = Associates Degree

    4 = Bachelor's Degree

    5 = Master's Degree

    6 = Doctorate

experience

int

Experience requirements

-

    1 = 0 years

    2 = Less than 2 years

    3 = 2-5 years

    4 = 5-10 years

    5 = More than 10 years

 

includeNonGeotaggableResumes

String(10)

Indicates that resumes that cannot be properly geotagged would still be added to search results

-

True | False

 

This field is meaningful only when radius is specified

 

False by default

resumesFound

int

Number of resumes found for this position so far

Ign.

Ign.

Read-only!

lastResumeFound

ISO8601 datetime (string)

When the last resume was found

Ign.

Ign.

Read-only!

createdDate

ISO8601 datetime (string)

When position was created

Ign.

Ign.

Read-only!

creatorAccountId

String(50)

ID of account who created the position

Ign.

Ign.

Read-only!

<keywords> Schema

 

<keywords><!-- Either <includeAll> or <includeAtLeastOneGroup> should be present; both can be included as well --><includeAll><!-- At least one <phrase> should be here --><phrase>phrase1</phrase><phrase>phrase2</phrase><phrase>phraseN</phrase></includeAll><includeAtLeastOneGroup><group><phrase>phrase1</phrase><phrase>phrase2</phrase><phrase>phraseN</phrase></group><group><phrase>phrase1</phrase><phrase>phrase2</phrase><phrase>phraseN</phrase></group></includeAtLeastOneGroup><!-- <noInclude> is optional --><noInclude><phrase>phrase1</phrase><phrase>phrase2</phrase><phrase>phraseN</phrase></noInclude></keywords>

<booleanKeywords>

SchemaThis is used for position “booleanKeywords” field

 

<booleanKeywords><!-- Either <includeAll> or <includeAtLeastOne> should be present; both can be included as well --><includeAll>cooker AND test AND NOT chef AND NOT foo</includeAll><includeAtLeastOne>garlic OR onion</includeAtLeastOne></booleanKeywords>