---
title: "Check whether content was created by Ideogram"
method: POST
path: "/v1/provenance/verify"
tags: ["provenance"]
---

# Check whether content was created by Ideogram

`POST /v1/provenance/verify`

Checks image content for an Ideogram provenance manifest (C2PA Content
Credentials) and returns the disclosure it carries: the provider name,
the generating system and its version, the creation time, and the
content's unique identifier.

Upload the image to verify as the `content` part.

This endpoint is public and unauthenticated — no API key is required.
Submitted content is analyzed in memory and never stored.

## Response `200`

The verification result.

- ProvenanceVerifyResponse
  - `provenance_detected` boolean, required — Whether an Ideogram provenance manifest was found in the content.
  - `validation_state` 'TRUSTED' | 'VALID' | 'INVALID' — Validation outcome for the detected manifest. `VALID` and `TRUSTED` both mean the content is unmodified since it was signed; `INVALID` means the content or its manifest was altered after signing.
  - `provider` string — Name of the provider that created the content.
  - `system_version` string — Version of the generation system that created the content.
  - `created_at` string — Creation time of the content, as an ISO 8601 timestamp.
  - `generation_id` string — Unique identifier of the generation, as a base64 URL-safe string.

## Other responses

- `400` — Invalid input, such as missing or unreadable content.
- `413` — The uploaded content is too large.
- `429` — Too many requests.

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/bd40f367a834/schema)
