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

# Get Artifact

> Retrieve metadata for an artifact

Retrieve metadata for an artifact, such as a financial spread's report or spreadsheet. The response includes the download content type and a suggested filename; it does not include the file itself. Fetch the bytes with [Download Artifact](/api-reference/artifacts/download-artifact).

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Path Parameters

<ParamField path="artifactId" type="string" required>
  The artifact id, from a spread's `artifacts` array or the `spread.completed`
  webhook.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="artifact" type="object">
  The artifact metadata.

  <Expandable title="artifact">
    <ResponseField name="id" type="string">
      The artifact id.
    </ResponseField>

    <ResponseField name="type" type="string">
      `REPORT` or `SPREADSHEET`.
    </ResponseField>

    <ResponseField name="title" type="string">
      Human-readable title.
    </ResponseField>

    <ResponseField name="summary" type="string">
      Short description of the artifact.
    </ResponseField>

    <ResponseField name="leadId" type="string | null">
      The lead the artifact belongs to, if any.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      When the artifact was created.
    </ResponseField>

    <ResponseField name="contentType" type="string">
      The MIME type served by `/content`: `application/pdf` for a `REPORT`,
      `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` for a
      `SPREADSHEET`.
    </ResponseField>

    <ResponseField name="filename" type="string">
      A suggested download filename, including the extension.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

<ResponseField name="404" type="error">
  No artifact with this id exists in your workspace.
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: "GET",
    headers: { "x-api-key": "<your-api-key>" },
  };

  fetch("https://api-v2.getomni.ai/api/v1/artifacts/art-report", options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  url = "https://api-v2.getomni.ai/api/v1/artifacts/art-report"
  headers = {"x-api-key": "<your-api-key>"}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api-v2.getomni.ai/api/v1/artifacts/art-report \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "artifact": {
      "id": "art-report",
      "type": "REPORT",
      "title": "Financial Spread - Pacific Coast Container Haulers",
      "summary": "Consolidated financial spread from 2 document(s).",
      "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
      "createdAt": "2026-07-23T18:08:38.000Z",
      "contentType": "application/pdf",
      "filename": "Financial Spread - Pacific Coast Container Haulers.pdf"
    }
  }
  ```
</ResponseExample>