> ## 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 Custom Sections

> List user-defined CV sections (e.g. "Volunteer Work", "Patents")

## Overview

Custom sections are user-defined CV blocks (e.g. "Volunteer Work", "Patents", "Languages"). Each section has a definition (title, icon, enabled fields) and zero or more items. List returns all section definitions with their items inline.

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

## Request

```bash theme={null}
GET /v1/custom-sections?limit=25&offset=0
```

### Query Parameters

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

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

<ParamField query="cvId" type="string">
  Target a specific resume by its id (from `list-resumes`). Omit to use your base/default resume; the resume must be self-contained.
</ParamField>

## Response

```json theme={null}
{
  "data": [
    {
      "id": "clx...",
      "sectionTitle": "Volunteer Work",
      "icon": "heart",
      "enabledFields": ["title", "organization", "description", "startDate", "endDate"],
      "displayOrder": 0,
      "items": [
        {
          "id": "cli...",
          "title": "Mentor",
          "organization": "Code Academy",
          "description": "Mentoring junior developers",
          "startDate": "2023-01",
          "endDate": null,
          "url": null,
          "displayOrder": 0
        }
      ],
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-01-15T10:00:00.000Z"
    }
  ],
  "total": 2,
  "hasMore": false,
  "limit": 25,
  "offset": 0
}
```