> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Profile

> Retrieve your full career profile in one call

## 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`.

<Note>
  **Scope required:** `profile:read` | **Rate limit:** 30 requests/min
</Note>

## Request

```bash theme={null}
GET /v1/profile
```

### Example

```bash theme={null}
curl "https://api.mokaru.ai/v1/profile" \
  -H "Authorization: Bearer mk_your_key"
```

## Response

The response is wrapped in `{ data: {...} }`.

```json theme={null}
{
  "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).