Skip to main content
GET
/
v1
/
profile
Get Profile
curl --request GET \
  --url https://api.mokaru.ai/v1/profile \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns the entire career profile in a single call. Useful for AI agents that need full context (cover letter writing, interview prep, profile analysis) without having to fetch each section separately. Includes:
  • Scalar fields: name, contact info, summary, sector, social links, plus a jobTitle derived from the user’s default resume
  • Collections: skills, workExperiences, educations, plus 8 sections: summaries, projects, certificates, awards, publications, interests, jobTitles, customSections
The collections return your base (default) resume’s content - the canonical content that new resumes are copied from. To read another resume’s content, fetch it via GET /v1/resume/:id.
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

The response is wrapped in { data: {...} }. 
{
  "data": {
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane@example.com",
    "phone": "+1 555-123-4567",
    "address": "San Francisco, CA",
    "country": "US",
    "province": "California",
    "jobTitle": "Software Engineer",
    "summary": "Experienced full-stack developer...",
    "sector": "Technology",
    "linkedIn": "https://linkedin.com/in/janesmith",
    "website": "https://janesmith.dev",
    "portfolio": "https://github.com/janesmith",

    "skills": [
      { "name": "TypeScript", "category": "TECHNICAL", "level": "Expert" }
    ],
    "workExperiences": [
      {
        "jobTitle": "Software Engineer",
        "company": "Tech Corp",
        "location": "San Francisco, CA",
        "startDate": "2022-07-01T00:00:00.000Z",
        "endDate": null,
        "isCurrent": true,
        "description": "...",
        "responsibilities": ["..."],
        "achievements": ["..."]
      }
    ],
    "educations": [
      {
        "school": "Stanford University",
        "degree": "Bachelor of Science",
        "field": "Computer Science",
        "startDate": "2018-09-01T00:00:00.000Z",
        "endDate": "2022-06-15T00:00:00.000Z",
        "isCurrent": false
      }
    ],

    "summaries": [
      { "title": "Technical", "content": "...", "displayOrder": 0 }
    ],
    "projects": [
      {
        "name": "Open Source CRM",
        "organisation": "Self-initiated",
        "description": "...",
        "startDate": "2023-01-01T00:00:00.000Z",
        "endDate": null,
        "isCurrent": true,
        "url": "https://github.com/..."
      }
    ],
    "certificates": [
      {
        "name": "AWS Solutions Architect Professional",
        "issuer": "Amazon Web Services",
        "description": "...",
        "issueDate": "2024-03-15T00:00:00.000Z",
        "expiryDate": "2027-03-15T00:00:00.000Z",
        "credentialId": "AWS-SAP-12345",
        "verificationUrl": "https://aws.amazon.com/verification/...",
        "skills": ["AWS", "Architecture"]
      }
    ],
    "awards": [
      {
        "name": "Best Engineer of the Year",
        "organisation": "ACM",
        "description": "...",
        "date": "2024-12-01T00:00:00.000Z"
      }
    ],
    "publications": [
      {
        "name": "Scaling React Apps to Millions of Users",
        "publisher": "Smashing Magazine",
        "date": "2024-05-10T00:00:00.000Z",
        "url": "https://...",
        "description": "..."
      }
    ],
    "interests": [
      { "name": "Photography", "description": "Landscape and street" }
    ],
    "jobTitles": [
      { "title": "Senior Software Engineer", "displayOrder": 0 }
    ],
    "customSections": [
      {
        "sectionTitle": "Volunteer Work",
        "icon": "heart",
        "enabledFields": ["title", "organization", "description"],
        "displayOrder": 0,
        "items": [
          {
            "title": "Mentor",
            "organization": "Code Academy",
            "description": "...",
            "startDate": "2023-01",
            "endDate": null,
            "url": null,
            "displayOrder": 0
          }
        ]
      }
    ]
  }
}

​
Notes

  • jobTitle (singular) comes from the user’s default resume’s jobTitle field. Use jobTitles (plural) for the multi-title career-identity list.
  • All collections return your base (default) resume’s content - the canonical content that new resumes are copied from. Other resumes own their own content - fetch via GET /v1/resume/:id.
  • Dates are ISO 8601 strings.
  • customSections.items.startDate and .endDate are free-form YYYY-MM strings (not ISO datetime).