Skip to main content

Overview

The Get Profile endpoint returns your career profile data from Mokaru. This includes your contact information, target job titles, skills, education history, and work experience. Common use cases:
  • AI agent context - give your AI agent access to your full career profile so it can write tailored cover letters, prepare interview answers, or suggest matching jobs without you having to repeat your background every time.
  • Resume generation - pull your profile into a custom template or external tool that formats resumes differently from Mokaru’s built-in builder.
  • Portfolio and personal site - automatically populate your portfolio website or personal landing page with up-to-date skills, experience, and education from your Mokaru profile.
  • Application autofill - use your profile data to pre-fill job application forms on company websites via an n8n or Make workflow.
Scope required: profile:read | Rate limit: 30 requests/min

Request

GET /v1/profile

Example

curl "https://api.mokaru.ai/v1/profile" \
  -H "Authorization: Bearer mk_your_key"

Response

firstName
string
First name
lastName
string
Last name
email
string
Email address
phone
string
Phone number
location
string
Current location
jobTitles
array
List of target job titles (strings)
skills
array
List of skills (strings)
education
array
Education history
experience
array
Work experience
{
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane@example.com",
  "phone": "+1 555-123-4567",
  "location": "San Francisco, CA",
  "jobTitles": ["Software Engineer", "Full Stack Developer"],
  "skills": ["TypeScript", "React", "Node.js", "PostgreSQL"],
  "education": [
    {
      "institution": "Stanford University",
      "degree": "Bachelor of Science",
      "field": "Computer Science",
      "startDate": "2018-09-01T00:00:00.000Z",
      "endDate": "2022-06-15T00:00:00.000Z"
    }
  ],
  "experience": [
    {
      "company": "Tech Corp",
      "title": "Software Engineer",
      "location": "San Francisco, CA",
      "startDate": "2022-07-01T00:00:00.000Z",
      "endDate": null,
      "description": "Building and maintaining the core platform"
    }
  ]
}