Api

Use to exchange a consumer ID and consumer secret for an authentication token.

APIDescription
POST Api

Exchanges a consumer ID and consumer secret for an authentication token.

Api/Account

Get or populate custom field values for a account/company.

APIDescription
GET Api/Account/CustomFields/{accountId}

Returns a list of custom fields for the given account.

GET Api/Account/{accountId}/CustomField/{customFieldName}

Returns a custom field.

POST Api/Account/{accountId}/CustomField

Sets a custom field for a company. The company and the custom field must exist.

Api/Account/History

APIDescription
PUT Api/Account/History/{accountId}

Adds a new history entry.

Api/Agnostic/Applicants

Provided mandator-agnostic methods to load applicants by global identifiers.

APIDescription
GET Api/Agnostic/Applicants/ByGlobalId/{globalId}

Fetch applicant/mandator information for a global ID.

Api/Applicant

Create, update or delete an applicant profile, including basic applicant information like name, address and job requirements.

APIDescription
GET Api/Applicant/{applicantId}

Returns an applicant profile by its ID, if it exists.

GET Api/Applicant?usernameOrEmail={usernameOrEmail}&password={password}

Returns an applicant profile by its user credentials, if it exists.

GET Api/Applicant?identifier={identifier}&thirdParty={thirdParty}

Returns an applicant profile identified by a third party profile identifier, if it exists.

GET Api/Applicant?email={email}&code={code}

Returns a specific applicant profile, identified by a "I forgot my password" token.

GET Api/Applicant/{applicantId}?token={token}

Returns an applicant profile for a specified ID and Auto-Logon-Token. Use this method to check if an applicant has a valid Auto-Logon-URL.

PUT Api/Applicant?sendRegistrationEmail={sendRegistrationEmail}&url={url}

Creates a new applicant profile.

POST Api/Applicant/{applicantId}

Updates an existing applicant profile.

PUT Api/Applicant/CoverLetter/{applicantId}

Adds a cover letter ("Anschreiben") to an existing applicant. It's possible to connect a cover letter to specific a job as well.

DELETE Api/Applicant/{applicantId}?deleteCompletely={deleteCompletely}

Deletes a specific applicant profile. You can choose if you want to completely remove an applicant, or just anonymize it. The latter is the default. It removes every piece of personal information, but keeps statistics intact.

Api/Applicant

Provides functionality to request and reset an applicants password.

APIDescription
POST Api/Applicant/RequestPassword?email={email}&url={url}&culture={culture}

Sends the "reset password" e-mail to the matching applicant. Throws HTTP404 if there is no applicant that matches the specified e-mail-address.

POST Api/Applicant/{applicantId}/ResetPassword

Sets an applicants password to a new value.

POST Api/Applicant/{applicantId}/SetPassword

Sets an applicants password to a new value, but only if the provided current password matches.

POST Api/Applicant/SetPassword

Sets an applicants password to a new value, but only if the provided reset-password-code matches.

GET Api/Applicant/{applicantId}/LogOnToken

Generates a log-on token for the given applicant.

Api/Applicant/{applicantId}/CustomField

Provides methods to create, read, update and delete custom field values from an applicant profile.

APIDescription
GET Api/Applicant/{applicantId}/CustomField/{customFieldName}

Returns the value of a specific custom field for a specific applicant profile.

POST Api/Applicant/{applicantId}/CustomField

Creates or updates the value of a custom field of a specific applicant.

DELETE Api/Applicant/{applicantId}/CustomField/{customFieldName}

Deletes a specific custom field value from an applicant profile.

Api/Applicant/{applicantId}/Policies

Provides functionality to read and update policies for an applicant.

APIDescription
GET Api/Applicant/{applicantId}/Policies

Returns all current policies for an applicant.

PUT Api/Applicant/{applicantId}/Policies/{policyId}

Updates a policy for an applicant.

Api/Applicant/{applicantId}/VideoInterviews

Provides functionality to handle video interviews for applicants.

APIDescription
GET Api/Applicant/{applicantId}/VideoInterviews

Fetch all video interviews for an applicant.

PUT Api/Applicant/{applicantId}/VideoInterviews

Creates an video interview for an applicant.

Api/Applicant/Activities

Provides methods to load all activities for a specific applicant profile.

APIDescription
GET Api/Applicant/Activities/{applicantId}

Returns all activities of a certain applicant.

Api/Applicant/Activity

Provides methods to create, read, update and delete activities from an applicant profile.

APIDescription
GET Api/Applicant/Activity/{id}

Returns a certain activity of an applicant.

PUT Api/Applicant/Activity/{applicantId}

Creates a new activity for a certain applicant.

POST Api/Applicant/Activity/{id}

Updates a specific applicant activity.

DELETE Api/Applicant/Activity/{id}

Deletes a specific applicant activity.

Api/Applicant/Certificate

Provides methods to create, read, update and delete additional education (ie. certificates) from an applicant profile.

APIDescription
GET Api/Applicant/Certificate/{id}

Returns a specific certificate of an applicant.

PUT Api/Applicant/Certificate/{applicantId}

Creates a new certificate for a specific applicant.

POST Api/Applicant/Certificate/{id}

Updates a specific applicant certificate.

DELETE Api/Applicant/Certificate/{id}

Deletes a specific applicant certificate.

Api/Applicant/Certificates

Provides methods to load the additional education (ie. certificates) for a specific applicant profile.

APIDescription
GET Api/Applicant/Certificates/{applicantId}

Returns all certificates of a certain applicant.

Api/Applicant/CustomFields

Provides methods to load the custom field values for a specific applicant profile.

APIDescription
GET Api/Applicant/CustomFields/{applicantId}

Returns all custom field values for a specific applicant profile. Only custom fields that have a value are returned, "empty" custom fields will be ignored.

Api/Applicant/Cv

Provides methods to create, read, update and delete the CV of an applicant profile.

APIDescription
GET Api/Applicant/Cv/{applicantId}?includeContent={includeContent}

Returns the CV of an applicant service.

PUT Api/Applicant/Cv/{applicantId}

Creates or updates the CV for a specific applicant profile.

POST Api/Applicant/Cv/{applicantId}

Creates or updates the CV for a specific applicant profile.

DELETE Api/Applicant/Cv/{applicantId}

Deletes the CV from an applicant profile.

Api/Applicant/Document

Provides methods to create, read, update and delete documents of an applicant profile.

APIDescription
GET Api/Applicant/Document/{id}?includeContent={includeContent}

Returns a document of an applicant service.

PUT Api/Applicant/Document/{applicantId}

Creates a document for a specific applicant profile.

POST Api/Applicant/Document/{id}

Updates a document for a specific applicant profile.

DELETE Api/Applicant/Document/{id}

Deletes a specific from an applicant profile.

Api/Applicant/Documents

Provides methods to load the documents for a specific applicant profile.

APIDescription
GET Api/Applicant/Documents/{applicantId}?includeContent={includeContent}

Returns all documents of a certain applicant.

Api/Applicant/Education

Provides methods to create, read, update and delete educations from an applicant profile.

APIDescription
GET Api/Applicant/Education/{id}

Returns a specific education of an applicant.

PUT Api/Applicant/Education/{applicantId}

Creates a new education for a specific applicant.

POST Api/Applicant/Education/{id}

Updates a specific applicant education.

DELETE Api/Applicant/Education/{id}

Deletes a specific applicant education.

Api/Applicant/Educations

Provides methods to load the education for a specific applicant profile.

APIDescription
GET Api/Applicant/Educations/{applicantId}

Returns all educations of a certain applicant.

Api/Applicant/EuropeanCv

Provides a method to gerenate the european CV for an applicant.

APIDescription
GET Api/Applicant/EuropeanCv/{applicantId}

Generates the european CV file for an applicant

Api/Applicant/Experience

Provides methods to create, read, update and delete work experience from an applicant profile.

APIDescription
GET Api/Applicant/Experience/{id}

Returns a specific work experience of an applicant.

PUT Api/Applicant/Experience/{applicantId}

Creates a new work experience for a specific applicant.

POST Api/Applicant/Experience/{id}

Updates a specific applicant work experience.

DELETE Api/Applicant/Experience/{id}

Deletes a specific applicant work experience.

Api/Applicant/Experiences

Provides methods to load the work experience for a specific applicant profile.

APIDescription
GET Api/Applicant/Experiences/{applicantId}

Returns all work experience of a certain applicant.

Api/Applicant/History

Creates a history entry for

APIDescription
PUT Api/Applicant/History/{applicantId}

Creates a new history entry for a specified applicant.

Api/Applicant/ImportantInfo

Provides methods to create, read, and delete important info for an applicant.

APIDescription
GET Api/Applicant/ImportantInfo/{applicantId}

Returns the important info property of an applicant.

DELETE Api/Applicant/ImportantInfo/User/{userId}/Applicant/{applicantId}

Deletes the important info value of the applicant

POST Api/Applicant/ImportantInfo/User/{userId}/Applicant/{applicantId}

Posts the important info value of the applicant

Api/Applicant/Knowledge

Provides methods to create, read, update and delete additional education (ie. certificates) from an applicant profile.

APIDescription
GET Api/Applicant/Knowledge/{applicantId}/{knowledge}

Returns a specific knowledge of an applicant.

PUT Api/Applicant/Knowledge/{applicantId}

Creates or updates a specific knowledge a a specific applicant.

POST Api/Applicant/Knowledge/{applicantId}

Creates or updates a specific knowledge a a specific applicant.

DELETE Api/Applicant/Knowledge/{applicantId}

Deletes a specific knowledge from a specific applicant.

Api/Applicant/Knowledges

Provides methods to load the knowledges for a specific applicant profile.

APIDescription
GET Api/Applicant/Knowledges/{applicantId}

Returns all knowledges of a certain applicant.

PUT Api/Applicant/Knowledges/{applicantId}

Creates, deletes or updates the knowledges of a certain applicant.

POST Api/Applicant/Knowledges/{applicantId}

Creates, deletes or updates the knowledges of a certain applicant.

DELETE Api/Applicant/Knowledges/{applicantId}

Creates, deletes or updates the knowledges of a certain applicant.

Api/Applicant/Language

Provides methods to create, read, update and delete a language skill from an applicant profile.

APIDescription
GET Api/Applicant/Language/{id}

Returns a specific language skill of an applicant.

PUT Api/Applicant/Language/{applicantId}

Creates a new language skill for a specific applicant.

POST Api/Applicant/Language/{id}

Updates a specific applicant language skill.

DELETE Api/Applicant/Language/{id}

Deletes a specific applicant language skill.

Api/Applicant/Languages

Provides methods to load the language skills for a specific applicant profile.

APIDescription
GET Api/Applicant/Languages/{applicantId}

Returns all language skills of a certain applicant.

Api/Applicant/LinkedIn

Provides methods the link or unlink an applicant profile to his/her LinkedIn Account.

APIDescription
POST Api/Applicant/LinkedIn/{applicantId}?identifier={identifier}&profileUrl={profileUrl}

Sets a link between an applicant profile and a LinkedIn account.

DELETE Api/Applicant/LinkedIn/{applicantId}

Removes the link between an applicant profile and a LinkedIn account.

Api/Applicant/Photo

Provides methods to create, read, update and delete the photo of an applicant profile.

APIDescription
GET Api/Applicant/Photo/{applicantId}?includeContent={includeContent}

Returns the photo of an applicant service.

PUT Api/Applicant/Photo/{applicantId}

Creates or updates the photo for a specific applicant profile.

POST Api/Applicant/Photo/{applicantId}

Creates or updates the photo for a specific applicant profile.

DELETE Api/Applicant/Photo/{applicantId}

Deletes the photo from an applicant profile.

Api/Applicant/Publication

Provides methods to load the publications for a specific applicant profile.

APIDescription
GET Api/Applicant/Publication/{id}

Returns a specific publication of an applicant.

PUT Api/Applicant/Publication/{applicantId}

Creates a new publication for a specific applicant.

POST Api/Applicant/Publication/{id}

Updates a specific applicant publication.

DELETE Api/Applicant/Publication/{id}

Deletes a specific applicant publication.

Api/Applicant/Publications

Provides methods to load the publications for a specific applicant profile.

APIDescription
GET Api/Applicant/Publications/{applicantId}

Returns all publications of a certain applicant.

Api/Applicant/Xing

Provides methods the link or unlink an applicant profile to his/her Xing Account.

APIDescription
POST Api/Applicant/Xing/{applicantId}?identifier={identifier}&profileUrl={profileUrl}

Sets a link between an applicant profile and a Xing account.

DELETE Api/Applicant/Xing/{applicantId}

Removes the link between an applicant profile and a Xing account.

Api/ApplicantCompass

Controller for the applicant compass feature on the applicant portal.

APIDescription
GET Api/ApplicantCompass/Questions?culture={culture}

Retrieve the questionnaire for the applicant compass.

GET Api/ApplicantCompass/InterestProfile/{id}

Retrieve an interest profile by its ID.

POST Api/ApplicantCompass/InterestProfiles/ForInterests

Retrieve the 3 best matching interest profiles for an applicant interest profile.

GET Api/ApplicantCompass/JobInsight/{id}?culture={culture}

Retrieve a job insight by ID.

Api/Applicants

Provides methods to load multiple applicant profiles at once.

APIDescription
GET Api/Applicants/ByEmail/{email}

Finds applicant profiles that match a certain email-address.

GET Api/Applicants/ByCustomField/{customField}?value={value}

Finds applicant profiles that match a certain custom field.

Api/Applicants/ByExternalId

Provides methods to load all applicants with a certain externalId.

APIDescription
GET Api/Applicants/ByExternalId/{externalId}

Returns applicants with

Api/Applicants/ByGlobalId

Provides methods to load all applicants with a globalId for a specific mandator.

APIDescription
GET Api/Applicants/ByGlobalId/{globalId}

Returns all applicants of current mandator with .

Api/Application

Provides methods to add or update an application (= the "connection" between an applicant and one or more jobs).

APIDescription
PUT Api/Application?url={url}&sendApplicationEmail={sendApplicationEmail}

Creates an application, which assigns an applicant to a job and sends an email to the applicant depending on the parameter.

POST Api/Application/Message

Sends a message to the recruiter that a new application was created.

POST Api/Application/{applicantJobId}

Updates an existing application. This is used to update an application referrer, but more importantly to execute a workflow activity.

POST Api/Application/{applicantJobId}/FinalizeCuteAssessment

Downloads the report for a completed cut-e assessment from cut-e servers, saves the file the the applicant and executes configured workflow steps.

Api/Applications

APIDescription
GET Api/Applications/ByReferrer/{referrer}?startAt={startAt}&endAt={endAt}

Get all applications for a certain referrer.

GET Api/Applications/ByJob/{jobId}

Get all open applications for a job.

Api/Applications

Provides methods the load all applications (= the "connection" between an applicant and one or more jobs) of an applicant.

APIDescription
GET Api/Applications/{applicantId}?culture={culture}

Gets all application of a specified applicant.

Api/CvParser

Provides an endpoint to parse a CV for the relevant personal applicant information.

APIDescription
POST Api/CvParser

Parses an applicants CV to extract relevant personal information. The CV parser strategy depends on the portal settings. Since this request does not provide information about the portal, it will use ePunkt CV parser.

POST Api/CvParser?uri={uri}

Parses an applicants CV to extract relevant personal information. Depending on the portal settings, this request uses a certain parsing strategies. Results may vary dependend on strategy and parsing mode.

Api/Feedback

Provides and endpoint to post user feedback.

APIDescription
PUT Api/Feedback?url={url}

Stores user feedback.

Api/Feeds

Provides an endpoint to liquid design Feed .

APIDescription
GET Api/Feeds/LiquidDesign/{mandatorId}?channel={channel}&culture={culture}&portalId={portalId}

Build a Liquid Design feed for the given mandator.

GET Api/Feeds/Hogast/{mandatorId}

Build a HOGASTjobs feed for the given mandator.

GET Api/Feeds/Hogast

Build a HOGASTjobs feed for all mandators.

GET Api/Feeds/JobsAt/{mandatorId}?channel={channel}&culture={culture}

Build a jobs.at feed for the provided mandator.

GET Api/Feeds/JobsAt?channel={channel}&culture={culture}

Build a jobs.at feed for all mandators.

GET Api/Feeds/Indeed/{mandatorId}?portalId={portalId}&channel={channel}&culture={culture}

Build an XML feed for Indeed.

Api/Integrations/ApplyWitheRecruiter

APIDescription
GET Api/Integrations/ApplyWitheRecruiter/{clientId}

Returns a specific integration.

POST Api/Integrations/ApplyWitheRecruiter/{clientId}

Post the candidate with vacancy id, you need to set two headers parameters "Content-Type: application/json" and "X-ApplyWith-Signature: Use Hash-based Message Authentication Code (HMAC) SHA256 hash function on your body with your client secret and encode to Base 64"

Api/Integrations/ATSi

APIDescription
POST Api/Integrations/ATSi/Job

No documentation available.

POST Api/Integrations/ATSi/Apply

No documentation available.

Api/Integrations/Indeed

APIDescription
POST Api/Integrations/Indeed

No documentation available.

Api/Integrations/KarriereOneClick

Provides an endpoint to KarriereOneClick integration.

APIDescription
POST Api/Integrations/KarriereOneClick

No documentation available.

Api/Job

Provides an endpoint to get details for a specific job. The only difference to the "PublishedJob" endpoint is that it returns a job regardless if it is published somewhere or not.

APIDescription
GET Api/Job/{jobId}?culture={culture}

Returns a job for the specified job-ID and culture.

POST Api/Job

Creates a new job and returns the newly job ID.

Api/Job

Provides an endpoint to create an graphic that represents the salary of a specific job.

APIDescription
GET Api/Job/SalaryImage/{jobId}

Creates the salary graphic for a specific job.

Api/Mailer

Controller for sending out-of-workflow e-mails.

APIDescription
POST Api/Mailer/Registration

Send an registration confirmation e-mail to the applicant.

POST Api/Mailer/Application

Send an application confirmation e-mail to the applicant.

POST Api/Mailer/DoubleOptIn?culture={culture}

Send a double-opt-in message to the possible applicant.

Api/Mandator

Provides an endpoint to get all API keys for a mandator. Requires the "Mandators" access level.

APIDescription
GET Api/Mandator/ApiKeys

Gets all API keys for all mandators.

GET Api/Mandator/{mandatorId}/ApiKeys

Gets all API keys for a specified mandator.

Api/Mandator

Provides an endpoint to manage the mandators of the current installation. Most important method is definitely GET Api/Mandator, because it returns all relevant types and configuration for the currently authenticated mandator.

APIDescription
GET Api/Mandator?uri={uri}

Returns information about the current mandator. This includes settings and available types.

GET Api/Mandator

Returns information about the current mandator. This includes settings and available types. The settings of the default applicant portal will be returned.

GET Api/Mandator/{mandatorId}

Returns information about a specific mandator. This includes settings and available types. The settings of the default applicant portal will be returned.

GET Api/Mandator/KnowledgeTree

Returns the full knowledge tree of the current mandator.

PUT Api/Mandator

Creates a new mandator. This also creates a set of default settings (workflow, types, ...) for this mandator.

POST Api/Mandator/{mandatorId}

Updates an existing mandator.

DELETE Api/Mandator/{mandatorId}

Deletes a mandator. WARNING: This removes _everything_ belonging to the mandator. Please be aware of that!

Api/Mandator/ApiKey

Provides an endpoint to manage API keys. Requires the "Mandators" access level.

APIDescription
GET Api/Mandator/ApiKey/{apiKeyId}

Gets a specific API key.

PUT Api/Mandator/ApiKey

Creates a new API key.

POST Api/Mandator/ApiKey/{apiKeyId}

Updates a specific API key.

DELETE Api/Mandator/ApiKey/{apiKeyId}

Deletes a specific API key.

Api/Mandators

Provides an endpoint to get all mandators of the installation. Requires the "Mandators" access level.

APIDescription
GET Api/Mandators?uri={uri}

Gets all mandators.

GET Api/Mandators

Gets all mandators.

Api/Ping

Provides functionality to check if the API endpoint is up and running and if authentication works.

APIDescription
GET Api/Ping

Simple ping method, just to see if the API is up and running and authentication works.

POST Api/Ping

Simple ping method, just to see if the API is up and running and authentication works.

Api/Policies

Provides an endpoint to read policies.

APIDescription
GET Api/Policies?portal={portal}&culture={culture}

Returns a list of policies.

GET Api/Policies/{policyId}

Returns a specific policy.

Api/PublishedJob

Provides an endpoint to get details for a single job that is published on a specific applicant portal or specific publication channel.

APIDescription
GET Api/PublishedJob/{jobId}?channel={channel}&culture={culture}&indeedWidgetEnabled={indeedWidgetEnabled}

Returns a job for the specified job-ID and culture, but only if the job is published on the specified channel.

Api/PublishedJobs

Provides an endpoint to get all jobs that are published on a specific applicant portal or specific publication channel.

APIDescription
GET Api/PublishedJobs?channel={channel}&culture={culture}

Returns a list of those jobs, that are published on an applicant portal or a specific publication channel.

Api/Questionnaire

Provides endpoints to get the metadata that describes a questionnaire.

APIDescription
GET Api/Questionnaire/ByJob/{jobId}?culture={culture}

Returns the questionnaire for a specific job. Throws HTTP404 if the specified job is not found. Throws HTTP403 if the specified job is not accesible. Throws HTTP400 if the the job is not available in the specified culture or if the specified job does not have a questionnaire.

GET Api/Questionnaire/{questionnaireId}

Returns a specific questionnaire Throws HTTP404 if the specified questionnaire is not found. Throws HTTP403 if the specified questionnaire is not accesible.

Api/Synchronize/Company

This controller is used to import companies for mandators. To use these class, it's required to have ApiAccessLevel "Company" enabled

APIDescription
PUT Api/Synchronize/Company?isValidationOnly={isValidationOnly}&requestTimeoutSeconds={requestTimeoutSeconds}

Create, update and delete Company data of the current mandator. Thus, this is a synchronization interface. The provided inputString (XML) will be validated against the XML Schema for company import. Please use it to generate your XML data. This method can be used to test data ingeration first and integrate data then.

Api/User

Provides an endpoint to manage users. Requires the "Users" access level.

APIDescription
GET Api/User/{userId}

Gets a specific user.

PUT Api/User

Creates a new user for the current mandator.

POST Api/User/{userId}

Updates an existing user.

DELETE Api/User/{userId}

Deletes an existing user. Warning: This may delete A LOT of related data. Handle with care!

DELETE Api/User/Merge/{userId}?mergeWithUserId={mergeWithUserId}

Deletes an existing user, but moves all related data to another user before.

Api/Users

Provides an endpoint to get all the users for the current mandator.

APIDescription
GET Api/Users

Gets all the users of the current mandator.

Api/Validation

Controller to handle important server-side validations.

APIDescription
GET Api/Validation/Password?password={password}&uri={uri}

Validate the provided password against the applicant portal password policy.

Api/VideoInterview/Cammio

The endpoint for Cammio notifications to complete a video interview.

APIDescription
POST Api/VideoInterview/Cammio

Receives a notification from Cammio and completes a video interview.