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>

• Related Articles

• API Methods

  Method Name Purpose getRecords To retrieve all users data specified in the API request getRecordById To retrieve individual records by record ID addRecords To insert records into the required Zoho Recruit module updateRecords To update or modify the ...