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

# Get detection info

> A machine-readable description of every Samsa marking technique, its decoder, and its hosted-decode status.

```
GET https://detect.samsa.ai/v1/public/detect/info
```

Returns a static, machine-readable description of the detection service: the methods it
applies, its retention posture, external verification links, and — per marking
technique — everything a third party needs to integrate and access detection
independently of Samsa.

This is the JSON counterpart of
[How detection works](https://detect.samsa.ai/how-detection-works), Samsa's public
Measure 3.4(b) information for the European Commission and other stakeholders. The
endpoint takes no parameters, reads no client data, and returns no PII.

```bash curl theme={null}
curl https://detect.samsa.ai/v1/public/detect/info
```

## Response

| Field                           | Type    | Description                                                                                                                                        |
| ------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `service`                       | string  | Service identifier.                                                                                                                                |
| `methods[]`                     | array   | The detection methods applied, each with a `type` (`metadata` or `watermark`), a `role` (`authoritative` or `corroboration`), and a `description`. |
| `retention`                     | string  | The retention posture, in prose.                                                                                                                   |
| `external_verification`         | object  | Links for verifying results independently of Samsa. Currently `c2pa`.                                                                              |
| `result_pdf_availability_hours` | integer | How long a [signed result PDF](/content-verification/results) stays downloadable.                                                                  |
| `marking_techniques[]`          | array   | Per-technique integration and access information — see [below](#marking-techniques).                                                               |
| `info_page_url`                 | string  | URL of the human-readable version of this information.                                                                                             |

### Marking techniques

Each entry in `marking_techniques[]` describes one technique:

| Field                           | Type           | Description                                                                                                                     |
| ------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `id`                            | string         | Stable technique id: `c2pa`, `trustmark-q`, or `video-seal`.                                                                    |
| `kind`                          | enum           | `metadata` or `watermark`.                                                                                                      |
| `modalities[]`                  | array          | Which of `image` and `video` the technique applies to.                                                                          |
| `display_name`                  | string         | Human-readable name.                                                                                                            |
| `description`                   | string         | What the technique is and what role it plays in the verdict.                                                                    |
| `algorithm_id`                  | string \| null | The C2PA-listed algorithm id. `null` for C2PA itself, which is a provenance manifest, not a soft-binding algorithm.             |
| `soft_binding_label_mappings[]` | array          | Per signing lane, the assertion `label` the soft-binding payload is carried under, with a `lane` name and explanatory `detail`. |
| `decoder`                       | string \| null | Where to get an independent decoder for this technique.                                                                         |
| `pinned_artifacts`              | object         | SHA-256 of the model artifacts Samsa has pinned, keyed by role (for example `encoder`, `decoder`).                              |
| `hosted_decode_status`          | enum           | `available` or `not_yet_available` — the status of **Samsa's hosted detector** for this technique.                              |
| `hosted_decode_detail`          | string         | The status in prose.                                                                                                            |
| `notes`                         | string \| null | A per-technique caveat, where one applies.                                                                                      |
| `info_url`                      | string         | URL of the human-readable description of this technique.                                                                        |

<Warning>
  `hosted_decode_status` describes **the detector**, not the marking. Both watermark
  techniques report `not_yet_available`: hosted watermark decode is scheduled before
  2 February 2027, and until then the detect endpoint reports those techniques as
  `not_checked`, never as a false “no watermark”.
</Warning>

<Accordion title="Full example response">
  ```json Response theme={null}
  {
    "service": "daku-detect",
    "methods": [
      {
        "type": "metadata",
        "role": "authoritative",
        "description": "C2PA manifest verification is the authoritative provenance signal: a valid, trusted, allowlisted Samsa manifest identifies content as created with Samsa."
      },
      {
        "type": "watermark",
        "role": "corroboration",
        "description": "Invisible watermark decodes provide best-effort corroboration and degrade gracefully when a decoder backend is unavailable; they never override the C2PA verdict."
      }
    ],
    "retention": "Samsa does not retain uploaded content: uploads are processed in memory and are never persisted or logged. Only a no-PII audit row (request id, coarse region bucket, verdict facts) is recorded.",
    "external_verification": {
      "c2pa": "https://verify.contentauthenticity.org"
    },
    "result_pdf_availability_hours": 24,
    "marking_techniques": [
      {
        "id": "c2pa",
        "kind": "metadata",
        "modalities": ["image", "video"],
        "display_name": "C2PA Content Credentials",
        "description": "Cryptographic provenance manifest embedded in the asset; the authoritative detection layer for both images and video.",
        "algorithm_id": null,
        "soft_binding_label_mappings": [],
        "decoder": "Validate with any independent C2PA validator (c2patool, verify.contentauthenticity.org) or with our hosted API POST /v1/public/detect.",
        "pinned_artifacts": {},
        "hosted_decode_status": "available",
        "hosted_decode_detail": "Live: C2PA manifest verification is served by our public API and by any independent C2PA validator.",
        "notes": "Trust anchoring per lane, split by asset SIZE rather than media type: the Trufo lane covers images and video up to the inline size ceiling, and Trufo's C2PA Root CA is on the official C2PA Trust List, so those manifests chain to a trust-listed root; the own-cert lane covers re-signed assets and anything above that ceiling, carrying the same assertions and validating structurally against the Samsa signer chain. Samsa's own C2PA conformance application (generator product 'Samsa Media Service') is filed and under review.",
        "info_url": "https://detect.samsa.ai/how-detection-works"
      },
      {
        "id": "trustmark-q",
        "kind": "watermark",
        "modalities": ["image"],
        "display_name": "TrustMark Q (image imperceptible watermark)",
        "description": "Adobe TrustMark Q imperceptible image watermark; a best-effort corroboration signal that never overrides the authoritative C2PA verdict.",
        "algorithm_id": "com.adobe.trustmark.Q",
        "soft_binding_label_mappings": [
          {
            "lane": "Trufo-signed (assets up to the inline size ceiling)",
            "label": "ai.samsa.soft-binding",
            "detail": "The Trufo wire contract rejects c2pa.* custom labels, so the standard soft-binding payload (naming com.adobe.trustmark.Q) is carried under this Samsa RDNN label. Third parties MUST read this label to find the signpost on Trufo-signed assets."
          },
          {
            "lane": "own-cert (re-signed assets and anything above the ceiling)",
            "label": "c2pa.soft-binding",
            "detail": "Own-cert-signed content carries the identical payload under the standard C2PA soft-binding label."
          }
        ],
        "decoder": "Adobe's open-source `trustmark` package (https://github.com/adobe/trustmark).",
        "pinned_artifacts": {
          "encoder": "80a3c3c0cb8cd16d0de4411ee7df122029424a0d5c510d875506adb90276bb9c",
          "decoder": "28b177ef112965e7e4bf2153b06f4464ce5ced52b68e6da3bbf5e1d15084f110"
        },
        "hosted_decode_status": "not_yet_available",
        "hosted_decode_detail": "Hosted watermark decode is not yet available in our public API; it is scheduled before 2 February 2027. Until then the API reports this technique as not_checked (never a constructed 'absent' false negative).",
        "notes": null,
        "info_url": "https://detect.samsa.ai/how-detection-works"
      },
      {
        "id": "video-seal",
        "kind": "watermark",
        "modalities": ["video"],
        "display_name": "Meta Video Seal (video imperceptible watermark)",
        "description": "Meta Video Seal imperceptible video watermark; a best-effort corroboration signal that never overrides the authoritative C2PA verdict.",
        "algorithm_id": "com.aiwatermark.videoseal.1",
        "soft_binding_label_mappings": [
          {
            "lane": "Trufo-signed (assets up to the inline size ceiling)",
            "label": "ai.samsa.soft-binding",
            "detail": "Signing-route selection is by asset SIZE, not by media type, so video signed through the Trufo lane carries the soft-binding under this Samsa RDNN label for the same reason images do (the Trufo wire contract rejects c2pa.* custom labels). Third parties MUST read this label as well as the standard one."
          },
          {
            "lane": "own-cert (re-signed assets and anything above the ceiling)",
            "label": "c2pa.soft-binding",
            "detail": "Own-cert-signed video carries the identical payload under the standard C2PA soft-binding label."
          }
        ],
        "decoder": "Open-source facebookresearch/videoseal (https://github.com/facebookresearch/videoseal).",
        "pinned_artifacts": {},
        "hosted_decode_status": "not_yet_available",
        "hosted_decode_detail": "Hosted watermark decode is not yet available in our public API; it lands with the watermark-interoperability work, before 2 February 2027.",
        "notes": "The VideoSeal watermark embed itself goes live with the video lane once its validation completes, a separate axis from provisioning the public detector; do not read this as hosted decode being live.",
        "info_url": "https://detect.samsa.ai/how-detection-works"
      }
    ],
    "info_page_url": "https://detect.samsa.ai/how-detection-works"
  }
  ```
</Accordion>

<Card title="How detection works" icon="fingerprint" href="https://detect.samsa.ai/how-detection-works">
  The same information as a human-readable page, including the trust-anchoring detail
  behind each signing lane.
</Card>
