Harmony API

Parse a resume

Parses a resume file and returns the structured (parsed) data along with the extracted raw text.

POST
/api/resume-parser

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token provided by Harmony.

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://beta.api.harmonyforstaffing.com/api/resume-parser" \  -F url="string"
{
  "resume": {
    "parsed": {
      "personalInfo": {
        "name": {
          "firstName": "Jane",
          "lastName": "Smith",
          "middleName": null
        },
        "contact": {
          "email": "jane.smith@email.com",
          "phone": "+15551234567",
          "alternativePhone": null,
          "linkedIn": "https://linkedin.com/in/janesmith"
        },
        "location": {
          "street": "123 Main St",
          "city": "San Francisco",
          "state": "CA",
          "zipCode": "94105",
          "country": "United States",
          "willingToRelocate": null
        }
      },
      "professionalSummary": {
        "overview": "Senior software engineer with 8 years of experience in full-stack development, specializing in React and Node.js with a strong background in distributed systems.",
        "yearsOfExperience": 8,
        "specialtyExperience": [
          {
            "specialty": "Full-Stack Development",
            "totalYears": 8,
            "lastPracticed": "2025-01-01",
            "settings": [
              "Enterprise",
              "Startup"
            ]
          }
        ],
        "coreProficiencies": [
          "Distributed Systems",
          "Microservices Architecture",
          "Cloud Infrastructure"
        ],
        "industryExpertise": [
          "SaaS",
          "FinTech"
        ]
      },
      "workHistory": [
        {
          "employer": "Acme Corp",
          "title": "Senior Software Engineer",
          "location": {
            "city": "San Francisco",
            "state": "CA",
            "remote": false,
            "inferred": false
          },
          "startDate": "2020-01-15",
          "endDate": null,
          "isCurrent": true,
          "monthsInRole": 60,
          "specialty": "Backend Engineering",
          "responsibilities": [
            "Led development of microservices architecture serving 1M+ users",
            "Mentored team of 5 junior engineers"
          ],
          "technologies": [
            "React",
            "Node.js",
            "PostgreSQL",
            "AWS"
          ],
          "skills": [
            {
              "name": "System Design",
              "category": "Architecture",
              "context": "Designed event-driven microservices platform"
            }
          ],
          "projectHighlights": [
            {
              "name": "Platform Migration",
              "description": "Led migration from monolith to microservices architecture",
              "outcomes": [
                "Reduced latency by 40%",
                "Improved deployment frequency by 3x"
              ]
            }
          ],
          "unitDepartment": "Platform Engineering",
          "floatedUnits": null,
          "prnDetails": null,
          "bedSize": null,
          "traumaLevel": null,
          "patientRatio": null
        }
      ],
      "education": [
        {
          "institution": "University of California, Berkeley",
          "degree": "Bachelor of Science",
          "major": "Computer Science",
          "minor": null,
          "startDate": "2012-08-01",
          "endDate": "2016-05-15",
          "location": {
            "city": "Berkeley",
            "state": "CA",
            "remote": false,
            "inferred": true
          }
        }
      ],
      "certifications": [
        {
          "name": "AWS Solutions Architect",
          "issuingOrganization": "Amazon Web Services",
          "issueDate": "2023-03-01",
          "expirationDate": null
        }
      ],
      "skills": {
        "technical": [
          {
            "category": "Programming Languages",
            "skills": [
              {
                "name": "TypeScript",
                "yearsOfExperience": 6,
                "proficiencyLevel": "Expert"
              },
              {
                "name": "Python",
                "yearsOfExperience": 4,
                "proficiencyLevel": "Advanced"
              }
            ]
          }
        ],
        "softSkills": [
          "Leadership",
          "Mentoring",
          "Technical Communication"
        ],
        "languages": [
          {
            "language": "English",
            "proficiency": "Native/Bilingual"
          },
          {
            "language": "Spanish",
            "proficiency": "Conversational"
          }
        ]
      },
      "additionalInfo": {
        "analysis": {
          "employmentGaps": []
        }
      }
    },
    "text": "Jane Smith\njane.smith@email.com\n+1 (555) 123-4567\n\nSenior software engineer with 8 years of experience..."
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}