Skip to main

API Technical Specs

Learn how to configure and leverage our services to achieve your toughest recruiting needs.
SaaS     |

Get a Job Order

GET /v10/index/(indexId)/joborder/(documentId)

Retrieves a single job order from an index.

  • You can try this endpoint out at our Swagger page ( US Data Center | EU Data Center | AU Data Center )
  • There should never be a need to call this endpoint. You should store/retrieve documents in your own database, since documents stored in indexes will have all PII redacted.

Path Parameters

ParameterData TypeDescription
indexIdstringThe id for the index that contains the document (case-insensitive).
documentIdstringThe id of the document to retrieve (case-insensitive).

Response Body

Infoobject
Information explaining the outcome of the transaction.
Info.Codestring
A response code elaborating on the HTTP status code.
The following is a list of codes that can be returned by the service:

Success– Successful transaction

MissingParameter- A required parameter wasn't provided

InvalidParameter- A parameter was incorrectly specified

AuthenticationError- An error occurred with the credentials provided

Unauthorized- Your account doesn't have permission to perform this operation

DataNotFound- Data with the specified name wasn't found
Info.Messagestring
This message further describes the code providing additional detail.
Info.TransactionIdstring
The (GUID) id for a specific API transaction. Use this when contacting support@sovren.com about issues.
Info.EngineVersionstring
The version of the parsing/matching engine running under-the-hood.
Info.ApiVersionstring
The version of the API.
Info.TotalElapsedMillisecondsinteger
How long the transaction took on Sovren's server, in milliseconds. If the transaction takes longer to complete on the client side, that extra duration is solely network latency.
Info.TransactionCostdecimal
How many credits the transaction costs.How many credits the transaction costs.
Info.CustomerDetailsobject
Information about the customer who made the API call.
Value.CustomerDetails.AccountIdstring
The AccountId for the account.
Value.CustomerDetails.Namestring
The customer name on the account.
Value.CustomerDetails.IPAddressstring
The client IP Address where the API call originated.
Value.CustomerDetails.Regionstring
The region for the account, also known as the 'Data Center'.
Value.CustomerDetails.CreditsRemainingdecimal
The number of credits remaining to be used by the account.
Value.CustomerDetails.CreditsUseddecimal
The number of credits used by the account.
Value.CustomerDetails.MaximumConcurrentRequestsinteger
The number of requests that can be made at one time. If using sub-accounts, this is the maximum number of concurent requests across all accounts, not just this single sub-account.
Value.CustomerDetails.ExpirationDatedate
The date that the current credits expire.
Valueobject
All of the information extracted while parsing a job order.
Value.CurrentJobIsManagementbool
Whether or not the job is a management position. Used by Sovren for AI Matching.
Value.HighestManagementScoreinteger
The management score. Used by Sovren for AI Matching.
Value.ManagementLevelbool
The management level. Used by Sovren for AI Matching.
Value.ExecutiveTypebool
What kind of executive position the job is, if any. Used by Sovren for AI Matching.
Value.MinimumYearsinteger
The minimum years experience for the job, if listed. Used by Sovren for AI Matching.
Value.MaximumYearsinteger
The maximum years experience for the job, if listed. Used by Sovren for AI Matching.
Value.MinimumYearsManagementinteger
The minimum years of management experience, if listed. Used by Sovren for AI Matching.
Value.MaximumYearsManagementinteger
The maximum years of management experience, if listed. Used by Sovren for AI Matching.
Value.RequiredDegreestring
The required educational degree, if listed. Used by Sovren for AI Matching.
Value.StartDatedate
The start date for the job, if listed.
Value.EndDatedate
The end date for the job, if listed.
Value.BillRateobject
The bill rate for the job, if listed.
Value.BillRate.Amountdecimal
The amount per UnitOfTime
Value.BillRate.Currencystring
The currency code. For example: "USD"
Value.BillRate.UnitOfTimestring
One of:
  • hour
  • day
  • week
  • month
  • year
Value.PayRateobject
The bill rate for the job, if listed.
Value.PayRate.Amountdecimal
The amount per UnitOfTime
Value.PayRate.Currencystring
The currency code. For example: "USD"
Value.PayRate.UnitOfTimestring
One of:
  • hour
  • day
  • week
  • month
  • year
Value.JobDescriptionstring
The full job description.
Value.JobRequirementsstring
Any requirement listed by the job.
Value.JobTitlesobject
The job titles found in the job. Used by Sovren for AI Matching.
Value.JobTitles.MainJobTitlestring
The main/overall job title.
Value.JobTitles.JobTitlestring[]
All job titles found in the job description.
Value.EmployerNamesobject
The employer names found in the job.
Value.EmployerNames.MainEmployerNamestring
The main/overall employer name.
Value.EmployerNames.EmployerNamestring[]
All employer names found in a job description.
Value.Degreesobject[]
The educational degrees found listed in the job. Used by Sovren for AI Matching.
Value.Degrees[i].Namestring
The name of the educational degree.
Value.Degrees[i].Typestring
The type of the educational degree.
Value.SchoolNamesstring[]
Any school names listed in the job.
Value.CertificationsAndLicensesstring[]
Any certifications/licenses listed in the job. Used by Sovren for AI Matching.
Value.LanguageCodesstring[]
Any languages listed in the job. Used by Sovren for AI Matching.
Value.CurrentLocationobject
The location of the job, if listed. Used by Sovren for AI Matching.
Value.CurrentLocation.CountryCodestring
The 2-letter ISO 3166 country code.
Value.CurrentLocation.PostalCodestring
The Postal or Zip code.
Value.CurrentLocation.Regionsstring[]
The Regions/Districts/States.
Value.CurrentLocation.Municipalitystring
The City/Municipality/Town.
Value.CurrentLocation.StreetAddressLinesstring
Street address lines.
Value.CurrentLocation.GeoCoordinatesobject
If geocoding has been done, this is the lat/lon for the location.
Value.CurrentLocation.GeoCoordinates.Latitudedecimal
The latitude, in degrees.
Value.CurrentLocation.GeoCoordinates.Longitudedecimal
The longitude, in degrees.
Value.CurrentLocation.GeoCoordinates.Sourcestring
The geocoding source, such as Google or Bing.
Value.TermsOfIntereststring[]
Terms of interest listed in the job.
Value.Ownersstring[]
Any owners of the job posting, if listed.
Value.SkillsDataobject[]
The skills found in the job. Used by Sovren for AI Matching.
Value.SkillsData[i].Rootstring
The name of the skills list that these taxonomies belong to.
Value.SkillsData[i].Taxonomiesobject[]
The skills taxonomies found in a resume.
Value.SkillsData[i].Taxonomies[j].Idstring
The id of the skills taxonomy.
Value.SkillsData[i].Taxonomies[j].Namestring
The human-readable name.
Value.SkillsData[i].Taxonomies[j].SubTaxonomiesobject[]
The subtaxonomy children of this taxonomy (more specific groupings of skills).
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].SubTaxonomyIdstring
The id of the subtaxonomy.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].SubTaxonomyNamestring
The human-readable name of the subtaxonomy.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].PercentOfOverallinteger
The percent (0-100) of skills found in the subtaxonomy compared to all subtaxonomies.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].PercentOfParentinteger
The percent (0-100) of skills found in the subtaxonomy compared to other subtaxonomies in the parent taxonomy
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skillsobject[]
The skills from the subtaxonomy that were found.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Requiredbool
True if this skill was listed as 'required' on the job description.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Idstring
The Id of the skill.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Namestring
The name of the skill.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].FoundInstring
Where the skill was found.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].ExistsInTextstring
Whether or not this skill was found verbatim in the text.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Variationsobject[]
The variations (synonyms) of this skill that were found.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Variations[n].Requiredbool
True if this skill was listed as 'required' on the job description.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Variations[n].Idstring
The Id of the skill.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Variations[n].Namestring
The name of the skill.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Variations[n].FoundInstring
Where the skill was found.
Value.SkillsData[i].Taxonomies[j].SubTaxonomies[k].Skills[m].Variations[n].ExistsInTextstring
Whether or not this skill was found verbatim in the text.
Value.SkillsData[i].Taxonomies[j].PercentOfOverallinteger
The percent (0-100) of skills found in the document that belong to this taxonomy.
Value.JobMetadataobject
Metadata about the parsed job
Value.JobMetadata.PlainTextstring
The plain text that was used for parsing.
Value.JobMetadata.DocumentLanguagestring
The two-letter ISO 639-1 code for the language the document was written in.
Value.JobMetadata.DocumentCulturestring
The xx-XX language/culture value for the parsed document.
Value.JobMetadata.ParserSettingsstring
The full parser settings that were used during parsing.
Value.JobMetadata.DocumentLastModifieddate
The last-revised/last-modified date that was provided for the document. This was used to calculate all of the important metrics about skills and jobs.
Value.JobMetadata.SovrenSignaturestring[]
A digital signature used to ensure there is no tampering between parsing and indexing. This prevents Sovren from storing any PII in the AI Matching engine.
Value.UserDefinedTagsstring[]
A list of User-Defined Tags that are assigned to this resume. These are used to filter search/match queries in the AI Matching Engine.

NOTE: you may add/remove these prior to indexing. This is the only property you may modify prior to indexing.

Sample Response

{ ... 
{ ... 
Code :  "Success",Message :  "string",TransactionId :  "string",TotalElapsedMilliseconds :  0,TransactionCost :  0,{ ... 
AccountId :  "string",Name :  "string",IPAddress :  "string",Region :  "string",CreditsRemaining :  0,CreditsUsed :  0,ExpirationDate :  "2020-11-03",MaximumConcurrentRequests :  0,
},
},
{ ... 
CurrentJobIsManagement :  true,HighestManagementScore :  0,ManagementLevel :  "string",ExecutiveType :  "string",MinimumYears :  0,MaximumYears :  0,MinimumYearsManagement :  0,MaximumYearsManagement :  0,RequiredDegree :  "string",StartDate :  "2020-11-03",EndDate :  "2020-11-03",{ ... 
Amount :  0,Currency :  "string",UnitOfTime :  "string",
},
{ ... 
Amount :  0,Currency :  "string",UnitOfTime :  "string",
},
JobDescription :  "string",JobRequirements :  "string",{ ... 
MainJobTitle :  "string",[ ... 
"string",
],
},
{ ... 
MainEmployerName :  "string",[ ... 
"string",
],
},
[ ... 
{
Name :  "string",Type :  "string",
},
],
[ ... 
"string",
],
[ ... 
"string",
],
[ ... 
"string",
],
{ ... 
CountryCode :  "string",PostalCode :  "string",[ ... 
"string",
],
Municipality :  "string",[ ... 
"string",
],
{ ... 
Latitude :  0,Longitude :  0,Source :  "string",
},
},
[ ... 
"string",
],
[ ... 
"string",
],
[ ... 
{
Root :  "string",[ ... 
{
[ ... 
{
[ ... 
{
Required :  true,[ ... 
{
Required :  true,Id :  "string",Name :  "string",FoundIn :  "string",ExistsInText :  true,
},
],
Id :  "string",Name :  "string",FoundIn :  "string",ExistsInText :  true,
},
],
PercentOfOverall :  0,PercentOfParent :  0,SubTaxonomyId :  "string",SubTaxonomyName :  "string",
},
],
Id :  "string",Name :  "string",PercentOfOverall :  0,
},
],
},
],
{ ... 
PlainText :  "string",DocumentLanguage :  "string",DocumentCulture :  "string",ParserSettings :  "string",DocumentLastModified :  "2020-11-03",[ ... 
"string",
],
},
[ ... 
"string",
],
},
}