GET /v1/artifacts/{artifact_id}/manifest

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/manifest"

{
  "object": "artifact_manifest",
  "id": "aman_example_123",
  "artifactId": "art_example_123",
  "kind": "markdown_bundle",
  "status": "ready",
  "filename": "aapl-10-k.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"
}

Get the structured manifest for one persisted artifact

Audience: developers verifying a persisted artifact’s file metadata and source context.

Coverage and source scope

Returns storage metadata, file size, checksum, optional filing and section context, and supported export formats for one organization-scoped artifact. Manifest citation fields are descriptive metadata; retain the cited filing reference when a downstream result needs source evidence.

Canonical metadata

artifactId
filename
contentType
storageMode
byteLength
lineCount
checksumSha1
filing
section
exportedFormats

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/manifest"

Example response

{
  "object": "artifact_manifest",
  "id": "aman_example_123",
  "artifactId": "art_example_123",
  "kind": "markdown_bundle",
  "status": "ready",
  "filename": "aapl-10-k.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"
}

Integrity and source context

checksumSha1, byteLength, and lineCount describe the persisted payload. filing and section are optional context captured while building the bundle; preserve their accession number, filing URL, and section key when a reviewer must return to the underlying disclosure. exportedFormats names the formats accepted by the export route.

Errors

A missing, inaccessible, or unresolved manifest returns 404 artifact_manifest_not_found.

Give this prompt to your agent

Failure posture

compare content with the returned checksum only for the persisted payload, not as proof of filing authenticity
retain filing and section context with any evidence workflow
do not infer a missing section is empty disclosure text

GET /v1/artifacts/{artifact_id}/export POST /v1/artifacts/{artifact_id}/reconcile

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Integrity and source context

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Integrity and source context

Errors

Give this prompt to your agent

Failure posture