senseloaf Apis (1.0.0)

Download OpenAPI specification:Download

This is senseloaf Api documents.

How to Use

Developer needs to call the Login api with the platform credentials to authenticate and receive the Bearer token. Bearer token validity is 10 days. On expiring, we can call Login API again. Bearer token needs to be passed in Authorization headers for all APIs.

Get Autorization token

Request Body schema: application/json
emailId
string
password
string

Responses

Request samples

Content type
application/json
{
  • "emailId": "string",
  • "password": "string"
}

Integration

Contains upload jds/resumes , creating multiple jobs/resumes.

upload job description

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

job description files to be upload

Responses

Response samples

Content type
application/json
{
  • "uploadedDocs": [
    ]
}

upload resume of candidate

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

candidate resume files to be upload

Responses

Response samples

Content type
application/json
{
  • "uploadedDocs": [
    ]
}

create bulk jobs

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json
userId
string

userId in Senseloaf platform.

organizationId
string

organizationId in Senseloaf platform.

idAtSource
string

Id of Job in Developers platform.

aboutCompany
string

Company Details in String

company
string

Company Name

companyLogoUrl
string

Logo URL

companySize
string

Number of employers

domains
Array of strings

List of company domains

foundedYear
string

Company founded Year

location
string

Company Location

perks
Array of strings

Perks inside company

jobRole
string

Job Role

positionCount
integer <int64>

Number of open positions for the Job.

educationRequired
Array of strings

education degrees

employmentType
string
jobCreationTime
string

Must be in format "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

lastJobViewedTime
string

Must be in format "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

jobDescription
string

Roles and Responsibilities

jobLink
string

jobLink

jobLocation
Array of strings

“City,Country” is the string format. Can include multiple locations.

latitude
Double

Latitude of Job location. Must be in range [-90, 90]

longitude
Double

Longitude of Job location. Must be in range [-180, 180]

minExperience
integer <int64>

Minimum years of Experience required for the job.

maxExperience
integer <int64>

Maximum years of Experience required for the job.

skills
Array of strings

skill set required

minSalary
integer <int64>

Amount of money

maxSalary
integer <int64>

Amount of money

currency
string

“INR”,“$”, "EUR”

currencyValue
string

XXX

salaryTime
string

Value: “perAnnum”,“perHour”

Responses

Request samples

Content type
application/json
{
  • "userId": "string",
  • "organizationId": "string",
  • "idAtSource": "string",
  • "aboutCompany": "string",
  • "company": "string",
  • "companyLogoUrl": "string",
  • "companySize": "string",
  • "domains": [
    ],
  • "foundedYear": "string",
  • "location": "string",
  • "perks": [
    ],
  • "jobRole": "string",
  • "positionCount": 0,
  • "educationRequired": [
    ],
  • "employmentType": "“Full Time”, “Part Time”, \"Contract\",\"Internship\"",
  • "jobCreationTime": "string",
  • "lastJobViewedTime": "string",
  • "jobDescription": "string",
  • "jobLink": "string",
  • "jobLocation": [
    ],
  • "latitude": null,
  • "longitude": null,
  • "minExperience": 0,
  • "maxExperience": 0,
  • "skills": [
    ],
  • "minSalary": 0,
  • "maxSalary": 0,
  • "currency": "string",
  • "currencyValue": "string",
  • "salaryTime": "string"
}

Response samples

Content type
application/json
{
  • "userId": "string",
  • "organizationId": "string",
  • "aboutCompany": "string",
  • "company": "string",
  • "companyLogoUrl": "string",
  • "companySize": "string",
  • "domains": [
    ],
  • "foundedYear": "string",
  • "minExperience": 0,
  • "maxExperience": 0,
  • "skills": [
    ],
  • "minSalary": 0,
  • "maxSalary": 0,
  • "currency": "string",
  • "currencyValue": "string",
  • "salaryTime": "string",
  • "educationRequired": [
    ],
  • "employmentType": "“Full Time”, “Part Time”, \"Contract\",\"Internship\"",
  • "jobCreationTime": "string",
  • "lastJobViewedTime": "string",
  • "jobDescription": "string",
  • "jobLink": "string",
  • "jobLocation": [
    ],
  • "jobId": "string",
  • "jobLocationLat": null,
  • "jobLocationLong": null,
  • "jobRole": "string",
  • "jobStatus": "string",
  • "location": "string",
  • "perks": [
    ],
  • "positionCount": 0,
  • "lookForJobRoles": [
    ],
  • "lookForLocations": [
    ],
  • "lookForSchools": [
    ],
  • "sharedTo": [
    ],
  • "histories": [
    ],
  • "geoLocation": {
    },
  • "closingDetail": {
    }
}

create bulk talents

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json
orgID
string

organizationId as in Senseloaf platform

idAtSource
integer <int64>
talentName
string

Candidate Name

talentEmail
string

Candidate contact email

talentContact
string

Candidate phone contact

totalWorkExperience
integer <int64>

Total year of work experience

currentJobRole
string

Current Job Role

currentCompany
string

Name of current company

currentCity
string

Candidate current city

currentCountry
string

Candidate current country

currentLocation
string

“City,Country” is the string format.

latitude
double

Latitude of candidate location. Must be in range [-90, 90]

longitude
double

Longitude of candidate location. Must be in range [-180, 180]

currentCTC
integer <int64>

Candidate current annual salary

ctcCurrency
string

Accepts “INR”,“$”,“EUR”

ctcCurrencyValue
string

XXX

profilePicThumbURL
string

Downloadable URL of image

resumeURL
string

Downloadable URL of resume. Accepts doc, docx, pdf, txt file

fileName
string

Filename of resume

fileType
string

Filetype of resume. Value : [ “pdf”, ”doc”, ”docx”, ”txt” ]

rawText
string

Resume text

Array of objects (Skill)
highestEducation
String
Enum: "High School" "Diploma" "Bachelor’s" "Master’s" "Doctorate"
Array of objects (Education)
Array of objects (Employment)
personalInfo
object
objective
string

Candidate objective as written in resume

achievements
Array of strings

list of achievements

gender
String
Enum: "Male" "Female" "Transgender"
Array of objects (URL)
source
string

Sourcing channel name

tags
Array of strings
lastUpdateDate
string

Must be in format "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

Responses

Request samples

Content type
application/json
{
  • "orgID": "string",
  • "idAtSource": 0,
  • "talentName": "string",
  • "talentEmail": "string",
  • "talentContact": "string",
  • "totalWorkExperience": 0,
  • "currentJobRole": "string",
  • "currentCompany": "string",
  • "currentCity": "string",
  • "currentCountry": "string",
  • "currentLocation": "Madrid, Spain",
  • "latitude": null,
  • "longitude": null,
  • "currentCTC": 0,
  • "ctcCurrency": "string",
  • "ctcCurrencyValue": "string",
  • "profilePicThumbURL": "string",
  • "resumeURL": "string",
  • "fileName": "string",
  • "fileType": "string",
  • "rawText": "string",
  • "skills": [
    ],
  • "highestEducation": "High School",
  • "education": [
    ],
  • "employment": [
    ],
  • "personalInfo": { },
  • "objective": "string",
  • "achievements": [
    ],
  • "gender": "Male",
  • "urls": [
    ],
  • "source": "string",
  • "tags": [
    ],
  • "lastUpdateDate": "string"
}

Response samples

Content type
application/json
{
  • "talentName": "string",
  • "talentEmail": "string",
  • "talentContact": "string",
  • "totalWorkExperience": 0,
  • "currentJobRole": "string",
  • "currentCompany": "string",
  • "currentCity": "string",
  • "currentCountry": "string",
  • "currentLocation": "Madrid, Spain",
  • "highestEducation": "High School",
  • "currentCTC": 0,
  • "ctcCurrency": "string",
  • "ctcCurrencyValue": "string",
  • "profilePicThumbURL": "string",
  • "resumeURL": "string",
  • "urls": [
    ],
  • "education": [
    ],
  • "employment": [
    ],
  • "objective": "string",
  • "achievements": [
    ],
  • "gender": "Male",
  • "lastUpdateDate": "string",
  • "status": "string",
  • "idAtSource": 0,
  • "integrationID": "string",
  • "orgID": {
    },
  • "source": "string",
  • "tags": [
    ],
  • "fileName": "string",
  • "fileType": "string",
  • "rawText": "string",
  • "latitude": null,
  • "longitude": null,
  • "geoLocation": {
    },
  • "preferredLocations": {
    },
  • "mentionedSkills": [
    ],
  • "experienceSkills": [
    ],
  • "processedJobs": [
    ],
  • "jobtalentIDS": [
    ]
}

Resume parser

parse resume uploaded by user.

parse resumes

Accepts resumes in doc ,docx, pdf ,png , jpeg format.Parse it and returns the parsed content

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

Resumes to be uploaded in doc,docx,pdf,png,jpeg format.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 8625,
  • "number_of_resumes": 2,
  • "errors": [ ],
  • "result": [
    ]
}

parse base64 string

Accepts resumes in base64 encoded string in request body , Parse it and returns the parsed content

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json

Downloadable resume url to be passed in request body

base64String
string

base 64 encoded string

extension
string

extension of file

fileName
string

file name

Responses

Request samples

Content type
application/json
{
  • "base64String": "",
  • "extension": "",
  • "fileName": ""
}

Response samples

Content type
application/json
{
  • "availableCredits": 8625,
  • "number_of_resumes": 2,
  • "errors": [ ],
  • "result": [
    ]
}

parse resumes by url

Accepts resumes url link in request body , Parse it and returns the parsed content

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json

Downloadable resume url to be passed in request body

resumeURL
string

Resume Downloadable link

Responses

Request samples

Content type
application/json
{
  • "resumeURL": ""
}

Response samples

Content type
application/json
{
  • "availableCredits": 8625,
  • "number_of_resumes": 2,
  • "errors": [ ],
  • "result": [
    ]
}

Job parser

parse job uploaded by user.

parse jobs

Accepts jobs in doc ,docx, pdf ,png , jpeg format.Parse it and returns the parsed content

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

Jobs to be uploaded in doc,docx,pdf,png,jpeg format.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 8625,
  • "number_of_jd": 2,
  • "errors": [ ],
  • "result": [
    ]
}

Semantic AI Matching

Contains matching Apis by docId, texts.

Matching By ID

query Parameters
isUploaded
required
boolean
Default: false

candidate resume files to be upload

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json

jobIds & resumeIds to be matched

jobIds
Array of strings
resumeIds
Array of strings

Responses

Request samples

Content type
application/json
{
  • "jobIds": [
    ],
  • "resumeIds": [
    ]
}

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "result": [
    ]
}

Matching By Texts

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json
Order
string
Enum: "JobToTalent" "TalentToJob" "SimilarTalent" "SimilarJobs"
object (DocumentRequest)
Array of objects (DocumentRequest)

Responses

Request samples

Content type
application/json
{
  • "Order": "JobToTalent",
  • "QueryDocument": {
    },
  • "SourceDocument": [
    ]
}

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "result": [
    ]
}

Deep AI Recommendations

contains Recommendations APis

Get Talents Recommendations

query Parameters
page
required
int32

page number

size
required
int32

page size

filter
required
boolean
Default: true

filter to be applied or not

sortBy
string

sort by field

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json
experienceEnd
integer <int64>
experienceStart
integer <int64>
overallScoreEnd
integer <int64>
overallScoreStart
integer <int64>
radius
integer <int64>
requiredVisa
string
source
string
dateAppliedStart
string

Must be in format "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

dateAppliedEnd
string

Must be in format "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

favourite
boolean
workAuthorization
boolean
companies
Array of strings
talentStatus
Array of strings

Talent status should be Lead eg: [ “Lead”]

domains
Array of strings
locations
Array of strings

Responses

Request samples

Content type
application/json
{
  • "experienceEnd": 0,
  • "experienceStart": 0,
  • "overallScoreEnd": 0,
  • "overallScoreStart": 0,
  • "radius": 0,
  • "requiredVisa": "string",
  • "source": "string",
  • "dateAppliedStart": "string",
  • "dateAppliedEnd": "string",
  • "favourite": true,
  • "workAuthorization": true,
  • "companies": [
    ],
  • "talentStatus": [
    ],
  • "domains": [
    ],
  • "locations": [
    ]
}

Response samples

Content type
application/json
{
  • "response": [
    ]
}

Run Talents Recommendations

Async API to run talent recommendations from your database. Accepts jobId (returned from create bulk job apis) and save talent recommendations in the database.

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json
jobid
string

Responses

Request samples

Content type
application/json
{
  • "jobid": "string"
}

Analyze Ids

contains APis for extracting & parsing Indonesian Ids,PAN card & Aadhar card.

Extract Indonesian Id card

Accepts indonesian id cards as Multipart document and returns parsed response.

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

Indonesian Id files to be uploaded.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "content": {
    },
  • "fileName": "string",
  • "image_links": [
    ],
  • "errors": [
    ]
}

Extract Aadhar Id card

Accepts Aadhaar id cards as Multipart document and returns parsed response.

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

Indonesian Id files to be uploaded.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "content": {
    },
  • "errors": [
    ],
  • "fileName": "string",
  • "image_links": [
    ]
}

Extract PAN card

Accepts PAN cards as Multipart document and returns parsed response.

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
files
required
string <binary>

Indonesian Id files to be uploaded.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "content": {
    },
  • "errors": [
    ],
  • "fileName": "string",
  • "image_links": [
    ]
}

Analyze Expenses

contains APis for parsing Invoice & Receipts.

upload Receipt file

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
file
required
string <binary>

receipt file to be upload . Accepted file formats are doc, docx, pdf, jpg and png format.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "content": {
    },
  • "errors": [
    ],
  • "fileName": "string"
}

upload Invoice file

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: multipart/form-data
file
required
string <binary>

Invoice file to be upload . Accepted file formats are doc, docx, pdf, jpg and png format.

Responses

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "content": {
    },
  • "errors": [
    ],
  • "fileName": "string"
}

Explainable Match

contains APis for explainable match.

Explainable Match Api

header Parameters
Authorization
required
string

Authorization header from login api

Request Body schema: application/json

jobIds & resumeIds to be matched

object (JDParserContent)
object (ResumeEMRequest)

Responses

Request samples

Content type
application/json
{
  • "jd": {
    },
  • "resume": {
    }
}

Response samples

Content type
application/json
{
  • "availableCredits": 0,
  • "result": [
    ]
}