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

> Get full work experience detail

## Overview

The Get Experience endpoint returns the full details of a specific work experience.

**Common use cases:**

* **Resume tailoring** - pull specific experience details to customize for a job application.
* **Cover letter generation** - use experience data to write targeted cover letters.
* **Career coaching** - review a specific role's responsibilities and achievements.

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

## Request

```bash theme={null}
GET /v1/experiences/{id}
```

### Example

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

## Response

<ResponseField name="data" type="object">
  Work experience detail

  <Expandable>
    <ResponseField name="id" type="string">Unique experience ID</ResponseField>
    <ResponseField name="jobTitle" type="string">Job title</ResponseField>
    <ResponseField name="company" type="string">Company name</ResponseField>
    <ResponseField name="location" type="string">Work location</ResponseField>
    <ResponseField name="startDate" type="string">ISO 8601 start date</ResponseField>
    <ResponseField name="endDate" type="string">ISO 8601 end date (null if current)</ResponseField>
    <ResponseField name="isCurrent" type="boolean">Whether this is the current position</ResponseField>
    <ResponseField name="description" type="string">Role description</ResponseField>
    <ResponseField name="responsibilities" type="array">List of responsibilities</ResponseField>
    <ResponseField name="achievements" type="array">List of achievements</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 creation date</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 last update date</ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "data": {
    "id": "clx1234...",
    "jobTitle": "Senior Software Engineer",
    "company": "Acme Corp",
    "location": "San Francisco, CA",
    "startDate": "2022-07-01T00:00:00.000Z",
    "endDate": null,
    "isCurrent": true,
    "description": "Building and maintaining the core platform",
    "responsibilities": ["Led frontend architecture", "Mentored junior developers"],
    "achievements": ["Reduced bundle size by 40%", "Shipped design system v2"],
    "createdAt": "2026-01-10T10:00:00.000Z",
    "updatedAt": "2026-03-15T14:30:00.000Z"
  }
}
```
