> ## 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 career profile data

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

<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

<ResponseField name="firstName" type="string">First name</ResponseField>
<ResponseField name="lastName" type="string">Last name</ResponseField>
<ResponseField name="email" type="string">Email address</ResponseField>
<ResponseField name="phone" type="string">Phone number</ResponseField>
<ResponseField name="location" type="string">Current location</ResponseField>
<ResponseField name="jobTitles" type="array">List of target job titles (strings)</ResponseField>
<ResponseField name="skills" type="array">List of skills (strings)</ResponseField>

<ResponseField name="education" type="array">
  Education history

  <Expandable>
    <ResponseField name="institution" type="string">School or university name</ResponseField>
    <ResponseField name="degree" type="string">Degree or certification</ResponseField>
    <ResponseField name="field" type="string">Field of study</ResponseField>
    <ResponseField name="startDate" type="string">ISO 8601 date</ResponseField>
    <ResponseField name="endDate" type="string">ISO 8601 date</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="experience" type="array">
  Work experience

  <Expandable>
    <ResponseField name="company" type="string">Company name</ResponseField>
    <ResponseField name="title" type="string">Job title</ResponseField>
    <ResponseField name="location" type="string">Work location</ResponseField>
    <ResponseField name="startDate" type="string">ISO 8601 date</ResponseField>
    <ResponseField name="endDate" type="string">ISO 8601 date (null if current)</ResponseField>
    <ResponseField name="description" type="string">Role description</ResponseField>
  </Expandable>
</ResponseField>

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