> ## Documentation Index
> Fetch the complete documentation index at: https://docs.overlap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Clip

> Retrieve a saved clip document by company and clip id

### Endpoint

```http theme={null}
GET https://api.joinoverlap.com/clip?companyId={companyId}&clipId={clipId}
```

Use this endpoint when you already have a `clipId` and need the latest saved clip document, including fields updated by `POST /update-clip`.

### Authentication

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

| Parameter   | Required | Description                                                  |
| ----------- | -------- | ------------------------------------------------------------ |
| `companyId` | Yes      | Your Overlap company or organization identifier.             |
| `clipId`    | Yes      | The clip id returned by `GET /workflow-results/{triggerId}`. |

<Info>
  The same lookup is also available at `GET /companies/{companyId}/clips/{clipId}`.
</Info>

## Response

Returns a [`Clip` object](/api-reference/clip-model). Clip fields are included when available, so a response may omit values that have not been generated or rendered yet. For example, `renderedUrl` may be absent.

```json theme={null}
{
  "clip": {
    "id": "clip-id-from-results",
    "title": "Product Launch Highlights",
    "bio": "Key moments from the product launch webinar.",
    "duration": 45.2,
    "subtitleConfig": {}
  }
}
```

The `clip` object is the saved clip document with `id` set to the Firestore document id.

<Card title="Clip Model" icon="square-kanban" color="#ff2700" href="/api-reference/clip-model">
  Review the fields that may appear on a clip response
</Card>

<RequestExample>
  ```javascript javascript theme={null}
  const response = await fetch(
    `https://api.joinoverlap.com/clip?companyId=${process.env.OVERLAP_COMPANY_ID}&clipId=clip-id-from-results`,
    {
      headers: {
        "Authorization": `Bearer ${process.env.OVERLAP_API_KEY}`
      }
    }
  );

  const data = await response.json();
  ```

  ```bash cURL theme={null}
  curl "https://api.joinoverlap.com/clip?companyId=$OVERLAP_COMPANY_ID&clipId=clip-id-from-results" \
       -H "Authorization: Bearer $OVERLAP_API_KEY"
  ```
</RequestExample>