Skip to main content
GET
/
v1
/
experiences
List Experiences
curl --request GET \
  --url https://api.mokaru.ai/v1/experiences \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "jobTitle": "<string>",
      "company": "<string>",
      "location": "<string>",
      "startDate": "<string>",
      "endDate": "<string>",
      "isCurrent": true,
      "description": "<string>",
      "responsibilities": [
        {}
      ],
      "achievements": [
        {}
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "total": 123,
  "hasMore": true,
  "limit": 123,
  "offset": 123
}

​
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.
Scope required: experiences:read | Rate limit: 60 requests/min

​
Request

GET /v1/experiences

​
Query Parameters

​
limit
number
default:"25"
Results per page (max 100)
​
offset
number
default:"0"
Number of results to skip for pagination

​
Example

curl "https://api.mokaru.ai/v1/experiences?limit=10" \
  -H "Authorization: Bearer mk_your_key"

​
Response

​
data
array
Array of work experiences
​
total
number
Total number of experiences
​
hasMore
boolean
Whether more pages are available
​
limit
number
Current page size
​
offset
number
Current offset
{
  "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
}