> ## 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 Resume Shares

> List the public share links for a resume

## Overview

Returns the public share links for a specific resume. In practice the in-app upsert behaviour means at most one share per resume exists, but the schema does not enforce uniqueness so this endpoint returns an array for forward-compatibility.

<Note>
  **Scope required:** `resume:share` | **Rate limit:** 30 requests/min
</Note>

## Request

```bash theme={null}
GET /v1/resume/{id}/share
```

### Path Parameters

<ParamField path="id" type="string" required>
  Resume id to list share links for
</ParamField>

### Example

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

## Response

<ResponseField name="data" type="array">
  Share list.

  <Expandable>
    <ResponseField name="id" type="string">Share row ID.</ResponseField>
    <ResponseField name="shareUrl" type="string">Public URL.</ResponseField>
    <ResponseField name="blurOptions" type="object">Privacy toggles snapshotted at create time.</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601.</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">Total shares for this resume.</ResponseField>
