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

# List Experiences

> List all work experiences for the authenticated user

## Overview

The List Experiences endpoint returns all work experiences in your Mokaru account. Use this to review career history or sync experience data with external tools.

**Common use cases:**

* **AI agent career review** - let your AI agent analyze your work history to suggest better job matches.
* **Resume building** - pull experience data to populate resumes or cover letters.
* **Career timeline** - export your work history to an external tool or spreadsheet.

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

## Request

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

### Query Parameters

<ParamField query="limit" type="number" default="25">
  Results per page (max 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of results to skip for pagination
</ParamField>

### Example

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

## Response

<ResponseField name="data" type="array">
  Array of work experiences

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

<ResponseField name="total" type="number">Total number of experiences</ResponseField>
<ResponseField name="hasMore" type="boolean">Whether more pages are available</ResponseField>
<ResponseField name="limit" type="number">Current page size</ResponseField>
<ResponseField name="offset" type="number">Current offset</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"
    }
  ],
  "total": 4,
  "hasMore": false,
  "limit": 10,
  "offset": 0
}
```