Skip to content
Tx Platform
Format Parsed Resume

Format a Parsed Resume🔗︎

This endpoint has been deprecated. Use this new endpoint instead.

HTTP Verb Path
POST /v9/formatter/resume

Format a Parsed Resume into a standardized DOCX or PDF file.

Info

Request Body🔗︎

ParsedDocument 🔗︎ string required

ParsedDocument🔗︎

The existing parsed JSON of a Resume.

Options 🔗︎ object required

Options🔗︎

Options for content/formatting of the generated resume document.


Options properties

OutputType 🔗︎ string required

OutputType🔗︎

Either DOCX or PDF

CompanyInfo 🔗︎ object

CompanyInfo🔗︎

Options for putting company/firm information on the formatted resume header.


CompanyInfo properties

CompanyName 🔗︎ string

CompanyName🔗︎

The company name to include in the resume header.

Phone 🔗︎ string

Phone🔗︎

The contact phone to include in the resume header.

Email 🔗︎ string

Email🔗︎

The contact email to include in the resume header.

CandidateId 🔗︎ string

CandidateId🔗︎

The candidate id for this resume to include in the resume header.

Footer 🔗︎ string

Any information (such as confidentiality clause) to put in the resume footer.

Placement 🔗︎ string

Placement🔗︎

Either FirstHeader (default) or AllHeaders.

Logo 🔗︎ object

The company logo to include in the resume header.


Logo properties

Logo 🔗︎ string required

The Base64-encoded image file to use as the logo (PNG, JPG, or SVG).

Width 🔗︎ integer required

Width🔗︎

The width of the logo in pixels.

Height 🔗︎ integer required

Height🔗︎

The height of the logo in pixels.

WorkHistory 🔗︎ object

WorkHistory🔗︎

Options to include/exclude certain data from the work history section of the resume.


WorkHistory properties

EmployerNames 🔗︎ string

EmployerNames🔗︎

One of:

  • ShowAll - shows all employers on the resume (this is the default value)
  • HideAll - hides all employers on the resume
  • HideRecentAndCurrent - hides only the most recent/current employers on the resume
MaxYearsOfWorkHistory 🔗︎ integer

MaxYearsOfWorkHistory🔗︎

Hides any positions from the original resume that ended longer than N years ago. This only applies in the case that NumPositions.Minimum (below) has been met. The default for this value is 10 years.

NumPositions 🔗︎ object

NumPositions🔗︎

The min/max number of positions/jobs to show.


NumPositions properties

Minimum 🔗︎ integer required

Minimum🔗︎

Positions from the original resume will be shown in chronological order until at least this number is met. Positions in excess of this number may be hidden depending on other settings. The default for this value is 2.

Maximum 🔗︎ integer required

Maximum🔗︎

No matter the end date, the generated resume will contain a maximum of this many positions from the original resume. The default for this value is 5.

Metadata 🔗︎ object

Metadata🔗︎

Options to show/hide Textkernel metadata on the generated resume.


Metadata properties

HideCandidateSummary 🔗︎ boolean

HideCandidateSummary🔗︎

Whether to hide the Textkernel candidate summary in the generated resume.

HideTopSkills 🔗︎ boolean

HideTopSkills🔗︎

Whether to hide the 'Top Skills' tree in the generated resume.

Sample JSON
{
  "ParsedDocument": "",
  "Options": {
    "OutputType": "",
    "CompanyInfo": {
      "CompanyName": "",
      "Phone": "",
      "Email": "",
      "CandidateId": "",
      "Footer": "",
      "Placement": "",
      "Logo": {
        "Logo": "",
        "Width": 0,
        "Height": 0
      }
    },
    "WorkHistory": {
      "EmployerNames": "",
      "MaxYearsOfWorkHistory": 0,
      "NumPositions": {
        "Minimum": 0,
        "Maximum": 0
      }
    },
    "Metadata": {
      "HideCandidateSummary": false,
      "HideTopSkills": false
    }
  }
}

Response Body🔗︎

Info 🔗︎ object

Info🔗︎

Information explaining the outcome of the transaction.


Info properties

Code 🔗︎ string

Code🔗︎

Code Description
Success Successful transaction
MissingParameter A required parameter wasn't provided
InvalidParameter A parameter was incorrectly specified
AuthenticationError An error occurred with the credentials provided
Message 🔗︎ string

Message🔗︎

This message further describes the code providing additional detail.

Value 🔗︎ object

Value🔗︎

Contains response data for the transaction.


Value properties

DocumentAsBase64String 🔗︎ string

DocumentAsBase64String🔗︎

The formatted resume document (either PDF or DOCX). This is a byte[] as a Base64-encoded string.

Sample JSON
{
  "Info": {
    "Code": "",
    "Message": ""
  },
  "Value": {
    "DocumentAsBase64String": ""
  }
}