Zoho Recruit | getAssociatedJobOpenings Method

getAssociatedJobOpenings

Purpose

You can use this method to get the data of the job openings associated with the candidates from third-party applications.

Request URL

XML Format:
https://recruit.zoho.com/recruit/private/xml/Candidates/getAssociatedJobOpenings?authtoken=AuthToken&scope=recruitapi&version=2

JSON Format:
https://recruit.zoho.com/recruit/private/json/Candidates/getAssociatedJobOpenings?authtoken=AuthToken&scope=recruitapi&version=2

For OAuth Authentication

Header Name
Value
Authorization
Zoho-oauthtoken {access_token}

Scopes

Scope=ZohoRecruit.modules.all
(or)
Scope=ZohoRecruit.modules.{scope_name}.{operation_type}
Possible Scope Names (Case Sensitive)
Operation Types
jobopening
ALL - Full access to the record
READ - Get records from the module

For Authtoken Authentication

Parameter
Data Type
Description
authtoken*
String
Encrypted alphanumeric string to authenticate your Zoho credentials. 
scope*
String
Specify the value as recruitapi

Request Parameters 

Parameter Data Type Description
id* String Specify unique ID of the Candidate record.
version* Integer Use version=2: This will fetch responses based on the latest API implementation
Note: Parameters marked with * are mandatory.

Example

To get the data of the candidates associated with the job openings from third-party applications.
URL Format:
http://recruit.zoho.com/recruit/private/xml/Candidates/getAssociatedJobOpenings?authtoken=AUTHTOKEN&scope=recruitapi&id=50000000033013
Response Format:
<response uri="/recruit/internal/xml/Candidates/getAssociatedJobOpenings">
<result>
<Candidates>
<row no="1">
<FL val="JOBOPENINGID">
<![CDATA[ 317865000000088095 ]]>
</FL>
<FL val="STATUS">
<![CDATA[ Associated ]]>
</FL>
</row>
<row no="2">
<FL val="JOBOPENINGID">
<![CDATA[ 317865000000088091 ]]>
</FL>
<FL val="STATUS">
<![CDATA[ Associated ]]>
</FL>
</row>
<row no="3">
<FL val="JOBOPENINGID">
<![CDATA[ 317865000000229441 ]]>
</FL>
<FL val="STATUS">
<![CDATA[ Submitted-to-client ]]>
</FL>
</row>
<row no="4">
<FL val="JOBOPENINGID">
<![CDATA[ 317865000000088153 ]]>
</FL>
<FL val="STATUS">
<![CDATA[ Interview-Scheduled ]]>
</FL>
</row>
</Candidates>
</result>
</response>