Profile Fields

Browse every section and field Aptora understands about a person's experience and capabilities. Each field shows its type, whether it's required, allowed values, and a concrete example from a sample “John Doe” profile.

* requiredobject nested fieldsarray repeatable liste.g. example value

firstNamestring | null

The candidate's first (given) name.

lastNamestring | null

The candidate's last (family) name.

namestring | null

The candidate's full name as shown on the resume. Derived from firstName + lastName; supply those instead. A bare name is split into them.

e.g.John Doe

infoobject | null

The 'info' section contains basic summary information for the candidate, including an optional label or job title, candidate photo, summary, and quote.

labelstring | null

A label for this resume, such as 'Full-Stack Developer'.

e.g.Senior Software Engineer

classstring | null

Profession type or 'character class'.

e.g.Software Development

imagestring | null

URL or path to your picture in JPEG, PNG, GIF, or BMP format.

e.g.https://johndoe.dev/avatar.jpg

briefstring | null

A short description or summary of yourself as a candidate.

e.g.Experienced full-stack developer with a passion for building scalable, reliable web applications.

quotestring | null

Candidate quote or byline.

e.g.Turning complex problems into elegant solutions.

dispositionobject | null

Describes the candidate's general attitude towards new employment opportunities (travel, relocation, schedule, etc.).

travelinteger | null

Percentage of time willing to travel (0 to 100).

e.g.25

authorizationstring | null

Work authorization: citizen, work visa, etc.

e.g.citizen

commitmentarray | null

Types of work desired: contract, perm, seasonal, etc.

e.g.full-time, contract

remoteboolean | null

Open to remote employment opportunities.

e.g.true

relocationobject | null

willingstring | null

Willingness to relocate.

e.g.true

destinationsarray | null

Preferred destinations for relocation

e.g.Berlin, Amsterdam

contactobject | null

The 'contact' section contains the candidate's contact information, including phone numbers, emails, websites, IMs, and custom contact types.

emailstring | null

Primary contact email in valid email format.

e.g.john.doe@example.com

phonestring | null

Primary phone number.

e.g.+1 (555) 123-4567

websitestring | null

Website, blog, or home page.

e.g.https://johndoe.dev

otherarray | nullof object

each item

labelstring | null

A label for this contact information.

e.g.Work

categorystring | null

Type of contact info: email, phone, url, postal, or IM.

e.g.email

valuestring | null

Phone number, email address, website, etc.

e.g.j.doe@techcorp.com

locationobject | null

The 'location' section, when present, contains the candidate's location and address info.

addressstring | null

Your full postal address.

e.g.123 Market Street

codestring | null

Postal or other official routing code.

e.g.94105

citystring | null

Your home city.

e.g.San Francisco

countrystring | null

Two-digit country code (US, AU, UK, IN, etc.).

e.g.US

regionstring | null

Your state, region, or province.

e.g.CA

employmentobject | null

The 'employment' section describes the candidate's formal employment history.

summarystring | null

Summary of overall employment.

e.g.10+ years of experience in software development.

historyarray | nullof object

each item

employer*string

Employer name.

e.g.Tech Corp

positionstring | null

Your position or formal job title.

e.g.Senior Software Engineer

urlstring | null

Employer website.

e.g.https://techcorp.com

startstring | null

Date you began work (YYYY-MM-DD).

e.g.2020-01-01

endstring | null

Date you finished work (YYYY-MM-DD).

e.g.2023-12-31

summarystring | null

A summary of your achievements and responsibilities under this employer.

e.g.Led development of core platform features.

highlightsarray | null

Noteworthy achievements and/or highlights.

e.g.Architected and implemented a microservices infrastructure., Improved system …

locationstring | null

Location of the job or position, e.g., 'San Francisco, CA'.

e.g.San Francisco, CA

keywordsarray | null

Keywords associated with this position.

e.g.TypeScript, Go, Kubernetes

projectsarray | nullof object

Describes the candidate's project history — specific projects, paid or unpaid.

each item

title*string

Project name or code-name.

e.g.Open Resume Toolkit

categorystring | null

Project type: open-source, private, side project, etc.

e.g.open-source

descriptionstring | null

Project description or summary.

e.g.A toolkit for parsing and rendering structured résumés.

summarystring | null

A summary of your achievements and responsibilities on the project.

e.g.Created and maintained a widely-used resume toolkit.

rolestring | null

Your role on the project: Contributor, Creator, etc.

e.g.Creator

urlstring | null

Project URL.

e.g.https://github.com/johndoe/open-resume

mediaarray | nullof object

Media associated with this project.

each item

category*string

Media category: image, thumbnail, screenshot, etc.

e.g.screenshot

namestring | null

Friendly media name.

e.g.Dashboard

urlstring | null

Media link, path, or location.

e.g.https://johndoe.dev/shot.png

repostring | null

Repo URL.

e.g.https://github.com/johndoe/open-resume

startstring | null

Date your involvement began (YYYY-MM-DD).

e.g.2019-03-01

endstring | null

Date your involvement ended (YYYY-MM-DD).

e.g.2021-08-01

highlightsarray | null

Noteworthy project-related achievements and/or highlights.

e.g.Reached 5k GitHub stars., Adopted by 3 companies.

locationstring | null

Freeform location, e.g., 'San Francisco, CA'.

e.g.Remote

keywordsarray | null

Keywords associated with this project.

e.g.TypeScript, JSON Schema

skillsobject | null

A description of the candidate's formal skills and capabilities.

setsarray | nullof object

each item

name*string

Name of the skillset: 'Programming', 'Project Management', etc.

e.g.Programming Languages

levelenum | null

Level of mastery of this skill.

e.g.Expert

skills*array

Titles or IDs of specific skills from the skills list.

e.g.JavaScript, TypeScript, Python, Go

listarray | nullof object

each item

name*string

The name or title of the skill.

e.g.Kubernetes

levelenum | null

Level of mastery of this skill.

e.g.Advanced

summarystring | null

A short summary of your experience with this skill.

e.g.Production cluster operations.

yearsnumber | null

Number of years you've used the skill.

e.g.4

serviceobject | null

Describes the candidate's overall service history (volunteer, military, etc.).

summarystring | null

Summary of overall service/volunteer experience.

e.g.Volunteer mentor and open-source contributor.

historyarray | nullof object

each item

organization*string

The service organization, e.g. Red Cross or National Guard.

e.g.Code for America

categorystring | null

Type of service work, e.g. volunteer or military.

e.g.volunteer

positionstring | null

Formal service role.

e.g.Mentor

urlstring | null

Organization website.

e.g.https://codeforamerica.org

startstring | null

Date joined (YYYY-MM-DD).

e.g.2018-01-01

endstring | null

Date left (YYYY-MM-DD).

e.g.2020-01-01

summarystring | null

A summary of achievements and responsibilities.

e.g.Mentored junior developers on civic-tech projects.

highlightsarray | null

Noteworthy achievements and/or highlights.

e.g.Mentored 12 developers.

keywordsarray | null

Keywords associated with this service.

e.g.Mentoring, Civic Tech

locationstring | null

Location, e.g. 'San Francisco, CA' or 'Tokyo'.

e.g.San Francisco, CA

educationobject | null

Describes the candidate's formal education (college, continuing ed, etc.).

levelstring

Highest level of education obtained (none, diploma, some-college, degree).

e.g.degree

summarystring | null

Summary of overall education.

e.g.Computer science degree with honors.

degreestring | null

Degree, if any (BSCS, BA, etc.).

e.g.BSCS

historyarray | nullof object

each item

institution*string

College or school name.

e.g.University of Technology

titlestring | null

A freeform title for this education (short name of degree, etc.).

e.g.B.Sc. Computer Science

areastring | null

E.g. Arts

e.g.Computer Science

studyTypestring | null

E.g. Bachelor

e.g.Bachelor

startstring | null

Start date (YYYY-MM-DD).

e.g.2010-09-01

endstring | null

End date (YYYY-MM-DD).

e.g.2014-05-31

gradestring | null

Grade or GPA.

e.g.3.9 GPA

curriculumarray | null

Notable courses, subjects, and experiences.

e.g.Algorithms, Distributed Systems

urlstring | null

School website or URL.

e.g.https://uot.edu

summarystring | null

A short summary of this education experience.

e.g.Focused on distributed systems and algorithms.

keywordsarray | null

Keywords associated with this education.

e.g.Algorithms, Systems

highlightsarray | null

Noteworthy achievements and/or highlights.

e.g.Graduated summa cum laude.

locationstring | null

Freeform location, e.g., 'San Francisco, CA'.

e.g.Boston, MA

socialarray | nullof object

Describes the candidate's participation in social networking (GitHub, Facebook, etc.).

each item

network*string

The name of the social network (Facebook, GitHub, etc.).

e.g.GitHub

user*string

The username or handle on the social network.

e.g.johndoe

url*string

Profile page URL.

e.g.https://github.com/johndoe

labelstring | null

A friendly label.

e.g.GitHub

recognitionarray | nullof object

Describes the candidate's public or professional awards and honors.

each item

title*string

Title of the award or recognition.

e.g.Engineer of the Year

categorystring | null

Type of recognition: award, honor, prize, etc.

e.g.award

datestring | null

Date awarded (YYYY-MM-DD).

e.g.2022-11-01

fromstring | null

Name of the awarding company, institution, or person.

e.g.Tech Corp

summarystring | null

A brief description of the award and why you received it.

e.g.Awarded for outstanding technical leadership.

urlstring | null

Associated URL.

e.g.https://techcorp.com/awards

writingarray | nullof object

Describes the candidate's writing and publication history (blogs, essays, books, etc.).

each item

title*string

Title of the article, essay, or book.

e.g.Scaling Microservices in Practice

categorystring | null

One of 'book', 'article', 'essay', 'blog post', or 'series'.

e.g.article

publisherobject | null

Publisher of the article, essay, or book.

namestring | null

Publisher name.

e.g.Dev Monthly

urlstring | null

Publisher website or URL.

e.g.https://devmonthly.com

datestring | null

Publication date (YYYY-MM-DD).

e.g.2021-06-15

urlstring | null

Website or URL of this publication.

e.g.https://devmonthly.com/scaling

summarystring | null

A brief summary of the publication.

e.g.A practical guide to scaling microservices.

readingarray | nullof object

Describes the candidate's reading habits, showing familiarity with industry publications.

each item

title*string

Title of the book, blog, or article.

e.g.Designing Data-Intensive Applications

categorystring | null

Type of reading: book, article, blog, magazine, etc.

e.g.book

urlstring | null

URL of the book, blog, or article.

e.g.https://dataintensive.net

authorarray | null

Author(s) of the book, blog, or article

e.g.Martin Kleppmann

datestring | null

Publication date (YYYY-MM-DD).

e.g.2017-03-16

summarystring | null

A brief description of the reading.

e.g.Essential reading on data systems.

speakingarray | nullof object

Describes speaking engagements and presentations.

each item

event*string

Event at which you presented.

e.g.DevConf 2022

titlestring | null

Speaking engagement title.

e.g.Building Resilient Systems

locationstring | null

Location of the event, e.g., 'San Francisco, CA'.

e.g.Berlin, Germany

datestring | null

Presentation date (YYYY-MM-DD).

e.g.2022-09-20

highlightsarray | null

Noteworthy achievements or highlights.

e.g.Best talk award.

keywordsarray | null

Keywords associated with this speaking engagement.

e.g.Resilience, Distributed Systems

summarystring | null

A description of this speaking engagement.

e.g.A talk on designing for failure.

governancearray | nullof object

Describes leadership, board, or committee roles.

each item

summarystring | null

Summary of your governance at this organization.

e.g.Served on the technical steering committee.

categorystring | null

Type of governance: committee, board, standards group, etc.

e.g.committee

rolestring | null

Governance role: board member, director, etc.

e.g.Member

organizationstring | null

The organization.

e.g.Open Resume Foundation

startstring | null

Start date (YYYY-MM-DD).

e.g.2021-01-01

endstring | null

End date (YYYY-MM-DD).

e.g.2023-01-01

keywordsarray | null

Keywords associated with this governance stint.

e.g.Standards

highlightsarray | null

Noteworthy achievements and/or highlights.

e.g.Shaped the résumé data standards roadmap.

languagesarray | nullof object

Describes the candidate's knowledge of world languages.

each item

language*string

The name of the language: English, Spanish, etc.

e.g.English

levelstring | null

Level of fluency, from 1 to 10 (or freeform).

e.g.Native

yearsnumber | null

Amount of time language spoken.

e.g.30

samplesarray | nullof object

Demonstration of the candidate's portfolio or work product.

each item

title*string

Title or descriptive name.

e.g.Portfolio Website

summarystring | null

A brief description of the sample.

e.g.Personal portfolio built with Next.js.

urlstring | null

URL of the sample.

e.g.https://johndoe.dev

datestring | null

Release date (YYYY-MM-DD).

e.g.2023-02-01

highlightsarray | null

Noteworthy achievements for this sample.

e.g.Lighthouse score 100.

keywordsarray | null

Keywords associated with this sample.

e.g.Next.js, Design

referencesarray | nullof object

Describes the candidate's personal, professional, and/or technical references.

each item

name*string

Full name of the person giving the reference.

e.g.Jane Smith

rolestring | null

Occupation or relationship to the candidate.

e.g.Engineering Manager

categorystring | null

Type of reference (professional, technical, personal).

e.g.professional

privateboolean | null

Is this a private reference?

e.g.false

summarystring | null

Summary information for this reference.

e.g.Worked directly with John for 3 years.

contactarray | nullof object

each item

labelstring | null

A label for this contact information.

e.g.Email

categorystring | null

Type of contact info: email, phone, url, postal, or IM.

e.g.email

valuestring | null

Phone number, email address, website, etc.

e.g.jane.smith@techcorp.com

testimonialsarray | nullof object

Public testimonials of the candidate's professionalism and character.

each item

name*string

Full name of the person giving the reference.

e.g.Jane Smith

quote*string

A quoted reference, e.g. 'Susan was an excellent team leader...'

e.g.John is one of the most reliable engineers I've worked with.

categorystring | null

Type of reference: personal, professional, or technical.

e.g.professional

privateboolean | null

Public reference or private contact?

e.g.false

interestsarray | nullof object

The 'interests' section provides a sampling of the candidate's hobbies or passions.

each item

name*string

The name/title of the interest or hobby.

e.g.Photography

summarystring | null

e.g.Landscape and street photography.

keywordsarray | null

Keywords associated with this interest.

e.g.Travel, Editing

extracurriculararray | nullof object

Describes the candidate's involvement with industry-related events/activities outside of work.

each item

title*string

Title of the extracurricular activity.

e.g.Hackathon Organizer

activity*string

The extracurricular activity.

e.g.Organizing local hackathons.

locationstring | null

City, state, or other freeform location.

e.g.San Francisco, CA

startstring | null

Start date (YYYY-MM-DD).

e.g.2019-01-01

endstring | null

End date (YYYY-MM-DD).

e.g.2022-01-01

affiliationobject | null

Describes the candidate's membership in groups, clubs, organizations, and professional associations.

summarystring | null

Optional summary of affiliation and membership experience.

e.g.Member of professional engineering associations.

historyarray | nullof object

each item

organization*string

The name of the organization or group.

e.g.ACM

categorystring | null

Type of affiliation: club, union, meetup, etc.

e.g.association

rolestring | null

Your role in the organization or group.

e.g.Member

urlstring | null

Organization website.

e.g.https://acm.org

startstring | null

Date affiliation began (YYYY-MM-DD).

e.g.2015-01-01

endstring | null

Date affiliation ended (YYYY-MM-DD).

e.g.2024-01-01

summarystring | null

A summary of achievements and responsibilities.

e.g.Active member of the ACM.

highlightsarray | null

Noteworthy achievements and/or highlights.

e.g.Attended annual conferences.

keywordsarray | null

Keywords associated with this affiliation.

e.g.Computing

locationstring | null

Freeform location, e.g., 'San Francisco, CA'.

e.g.Global

Full sample profile (John Doe) — JSON

{
  "name": "John Doe",
  "info": {
    "label": "Senior Software Engineer",
    "class": "Software Development",
    "image": "https://johndoe.dev/avatar.jpg",
    "brief": "Experienced full-stack developer with a passion for building scalable, reliable web applications.",
    "quote": "Turning complex problems into elegant solutions."
  },
  "disposition": {
    "travel": 25,
    "authorization": "citizen",
    "commitment": [
      "full-time",
      "contract"
    ],
    "remote": true,
    "relocation": {
      "willing": true,
      "destinations": [
        "Berlin",
        "Amsterdam"
      ]
    }
  },
  "contact": {
    "email": "john.doe@example.com",
    "phone": "+1 (555) 123-4567",
    "website": "https://johndoe.dev",
    "other": [
      {
        "label": "Work",
        "category": "email",
        "value": "j.doe@techcorp.com"
      }
    ]
  },
  "location": {
    "address": "123 Market Street",
    "code": "94105",
    "city": "San Francisco",
    "country": "US",
    "region": "CA"
  },
  "employment": {
    "summary": "10+ years of experience in software development.",
    "history": [
      {
        "employer": "Tech Corp",
        "position": "Senior Software Engineer",
        "url": "https://techcorp.com",
        "start": "2020-01-01",
        "end": "2023-12-31",
        "summary": "Led development of core platform features.",
        "highlights": [
          "Architected and implemented a microservices infrastructure.",
          "Improved system performance by 40% through optimization."
        ],
        "location": "San Francisco, CA",
        "keywords": [
          "TypeScript",
          "Go",
          "Kubernetes"
        ]
      }
    ]
  },
  "projects": [
    {
      "title": "Open Resume Toolkit",
      "category": "open-source",
      "description": "A toolkit for parsing and rendering structured résumés.",
      "summary": "Created and maintained a widely-used resume toolkit.",
      "role": "Creator",
      "url": "https://github.com/johndoe/open-resume",
      "media": [
        {
          "category": "screenshot",
          "name": "Dashboard",
          "url": "https://johndoe.dev/shot.png"
        }
      ],
      "repo": "https://github.com/johndoe/open-resume",
      "start": "2019-03-01",
      "end": "2021-08-01",
      "highlights": [
        "Reached 5k GitHub stars.",
        "Adopted by 3 companies."
      ],
      "location": "Remote",
      "keywords": [
        "TypeScript",
        "JSON Schema"
      ]
    }
  ],
  "skills": {
    "sets": [
      {
        "name": "Programming Languages",
        "level": "Expert",
        "skills": [
          "JavaScript",
          "TypeScript",
          "Python",
          "Go"
        ]
      }
    ],
    "list": [
      {
        "name": "Kubernetes",
        "level": "Advanced",
        "summary": "Production cluster operations.",
        "years": 4
      }
    ]
  },
  "service": {
    "summary": "Volunteer mentor and open-source contributor.",
    "history": [
      {
        "category": "volunteer",
        "organization": "Code for America",
        "position": "Mentor",
        "url": "https://codeforamerica.org",
        "start": "2018-01-01",
        "end": "2020-01-01",
        "summary": "Mentored junior developers on civic-tech projects.",
        "highlights": [
          "Mentored 12 developers."
        ],
        "keywords": [
          "Mentoring",
          "Civic Tech"
        ],
        "location": "San Francisco, CA"
      }
    ]
  },
  "education": {
    "summary": "Computer science degree with honors.",
    "level": "degree",
    "degree": "BSCS",
    "history": [
      {
        "title": "B.Sc. Computer Science",
        "institution": "University of Technology",
        "area": "Computer Science",
        "studyType": "Bachelor",
        "start": "2010-09-01",
        "end": "2014-05-31",
        "grade": "3.9 GPA",
        "curriculum": [
          "Algorithms",
          "Distributed Systems"
        ],
        "url": "https://uot.edu",
        "summary": "Focused on distributed systems and algorithms.",
        "keywords": [
          "Algorithms",
          "Systems"
        ],
        "highlights": [
          "Graduated summa cum laude."
        ],
        "location": "Boston, MA"
      }
    ]
  },
  "social": [
    {
      "network": "GitHub",
      "user": "johndoe",
      "url": "https://github.com/johndoe",
      "label": "GitHub"
    }
  ],
  "recognition": [
    {
      "category": "award",
      "title": "Engineer of the Year",
      "date": "2022-11-01",
      "from": "Tech Corp",
      "summary": "Awarded for outstanding technical leadership.",
      "url": "https://techcorp.com/awards"
    }
  ],
  "writing": [
    {
      "title": "Scaling Microservices in Practice",
      "category": "article",
      "publisher": {
        "name": "Dev Monthly",
        "url": "https://devmonthly.com"
      },
      "date": "2021-06-15",
      "url": "https://devmonthly.com/scaling",
      "summary": "A practical guide to scaling microservices."
    }
  ],
  "reading": [
    {
      "title": "Designing Data-Intensive Applications",
      "category": "book",
      "url": "https://dataintensive.net",
      "author": "Martin Kleppmann",
      "date": "2017-03-16",
      "summary": "Essential reading on data systems."
    }
  ],
  "speaking": [
    {
      "title": "Building Resilient Systems",
      "event": "DevConf 2022",
      "location": "Berlin, Germany",
      "date": "2022-09-20",
      "highlights": [
        "Best talk award."
      ],
      "keywords": [
        "Resilience",
        "Distributed Systems"
      ],
      "summary": "A talk on designing for failure."
    }
  ],
  "governance": [
    {
      "summary": "Served on the technical steering committee.",
      "category": "committee",
      "role": "Member",
      "organization": "Open Resume Foundation",
      "start": "2021-01-01",
      "end": "2023-01-01",
      "keywords": [
        "Standards"
      ],
      "highlights": [
        "Shaped the résumé data standards roadmap."
      ]
    }
  ],
  "languages": [
    {
      "language": "English",
      "level": "Native",
      "years": 30
    },
    {
      "language": "German",
      "level": "B2",
      "years": 5
    }
  ],
  "samples": [
    {
      "title": "Portfolio Website",
      "summary": "Personal portfolio built with Next.js.",
      "url": "https://johndoe.dev",
      "date": "2023-02-01",
      "highlights": [
        "Lighthouse score 100."
      ],
      "keywords": [
        "Next.js",
        "Design"
      ]
    }
  ],
  "references": [
    {
      "name": "Jane Smith",
      "role": "Engineering Manager",
      "category": "professional",
      "private": false,
      "summary": "Worked directly with John for 3 years.",
      "contact": [
        {
          "label": "Email",
          "category": "email",
          "value": "jane.smith@techcorp.com"
        }
      ]
    }
  ],
  "testimonials": [
    {
      "name": "Jane Smith",
      "quote": "John is one of the most reliable engineers I've worked with.",
      "category": "professional",
      "private": false
    }
  ],
  "interests": [
    {
      "name": "Photography",
      "summary": "Landscape and street photography.",
      "keywords": [
        "Travel",
        "Editing"
      ]
    }
  ],
  "extracurricular": [
    {
      "title": "Hackathon Organizer",
      "activity": "Organizing local hackathons.",
      "location": "San Francisco, CA",
      "start": "2019-01-01",
      "end": "2022-01-01"
    }
  ],
  "affiliation": {
    "summary": "Member of professional engineering associations.",
    "history": [
      {
        "category": "association",
        "organization": "ACM",
        "role": "Member",
        "url": "https://acm.org",
        "start": "2015-01-01",
        "end": "2024-01-01",
        "summary": "Active member of the ACM.",
        "highlights": [
          "Attended annual conferences."
        ],
        "keywords": [
          "Computing"
        ],
        "location": "Global"
      }
    ]
  }
}