GET /v1/artifacts/{artifact_id}

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/artifacts/art_example_123"

{
  "object": "artifact",
  "id": "art_example_123",
  "createdAt": "2026-03-19T12:00:00.000Z",
  "livemode": false,
  "kind": "markdown_bundle",
  "status": "ready",
  "manifest": {
    "object": "artifact_manifest",
    "id": "aman_example_123",
    "artifactId": "art_example_123",
    "kind": "markdown_bundle",
    "status": "ready",
    "filename": "aapl-10-k-item-1a.md",
    "contentType": "text/markdown; charset=utf-8",
    "storageMode": "local",
    "objectKey": null,
    "byteLength": 18432,
    "lineCount": 420,
    "checksumSha1": "example_checksum",
    "filing": {
      "accessionNumber": "0000320193-25-000079",
      "form": "10-K",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927_htm.xml"
    },
    "section": {
      "key": "item_1a",
      "title": "Risk Factors"
    },
    "exportedFormats": [
      "json",
      "markdown",
      "compact_json"
    ],
    "createdAt": "2026-03-19T12:00:00.000Z"
  },
  "provenance": {
    "accessionNumber": "0000320193-25-000079",
    "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927_htm.xml"
  }
}

Get one persisted artifact and its manifest

Audience: developers retrieving one organization-scoped artifact before an export or download.

Coverage and source scope

Returns the saved artifact record and its structured manifest when the artifact belongs to the authenticated organization. Use the manifest or export routes when a workflow needs explicit file metadata or an export envelope.

Canonical metadata

id
kind
status
manifest
provenance

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/artifacts/art_example_123"

Example response

{
  "object": "artifact",
  "id": "art_example_123",
  "createdAt": "2026-03-19T12:00:00.000Z",
  "livemode": false,
  "kind": "markdown_bundle",
  "status": "ready",
  "manifest": {
    "object": "artifact_manifest",
    "id": "aman_example_123",
    "artifactId": "art_example_123",
    "kind": "markdown_bundle",
    "status": "ready",
    "filename": "aapl-10-k-item-1a.md",
    "contentType": "text/markdown; charset=utf-8",
    "storageMode": "local",
    "objectKey": null,
    "byteLength": 18432,
    "lineCount": 420,
    "checksumSha1": "example_checksum",
    "filing": {
      "accessionNumber": "0000320193-25-000079",
      "form": "10-K",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927_htm.xml"
    },
    "section": {
      "key": "item_1a",
      "title": "Risk Factors"
    },
    "exportedFormats": [
      "json",
      "markdown",
      "compact_json"
    ],
    "createdAt": "2026-03-19T12:00:00.000Z"
  },
  "provenance": {
    "accessionNumber": "0000320193-25-000079",
    "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927_htm.xml"
  }
}

Identity and provenance

Use an ID returned by the artifact list or create response. The returned record includes its saved manifest; use the manifest route when only file metadata is needed and the download route when payload retrieval is needed. When the bundle carries filing provenance, preserve that filing reference with any extracted content rather than relying on the artifact ID as a source citation.

Errors

A missing, inaccessible, or unresolved artifact returns 404 artifact_not_found. Without an organization on the authenticated principal, the route returns 403 organization_missing.

Give this prompt to your agent

Failure posture

do not substitute another artifact when an ID returns 404
retain the artifact ID and manifest checksum before handing content to another system
preserve filing provenance when the result is used as evidence

POST /v1/artifacts GET /v1/artifacts/{artifact_id}/download

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Identity and provenance

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Identity and provenance

Errors

Give this prompt to your agent

Failure posture