Get watermark result

curl --request GET \
  --url https://api.identifai.net/api/v2/watermark/{id} \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.identifai.net/api/v2/watermark/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.identifai.net/api/v2/watermark/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.identifai.net/api/v2/watermark/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.identifai.net/api/v2/watermark/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "674a3c9b8e2d4f12b7c9a8d3",
  "status": "inprogress",
  "result": null
}

Get watermark result

curl --request GET \
  --url https://api.identifai.net/api/v2/watermark/{id} \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.identifai.net/api/v2/watermark/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.identifai.net/api/v2/watermark/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.identifai.net/api/v2/watermark/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.identifai.net/api/v2/watermark/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "674a3c9b8e2d4f12b7c9a8d3",
  "status": "inprogress",
  "result": null
}

Poll this endpoint with the id returned by Apply watermark to follow the progress of a watermarking submission.

`status`	Meaning	`result`
`new` / `inprogress`	The submission is queued or being processed.	`null`
`done`	Processing finished.	Populated with `applied_watermarks` and, if any watermark was applied, a `download_url`.
`errored`	Processing failed.	`null` — see `watermarks_errors`.

When status is done, result.download_url is a pre-signed URL that stays valid until result.expires_at. Some policies may fail while others succeed: check result.errors and result.applied_watermarks to see exactly what was applied.

Example request

curl https://api.identifai.net/api/v2/watermark/674a3c9b8e2d4f12b7c9a8d3 \
  -H "X-Api-Key: $IDENTIFAI_API_KEY"

{
  "id": "674a3c9b8e2d4f12b7c9a8d3",
  "status": "done",
  "result": {
    "errors": [],
    "applied_watermarks": ["european-watermarks", "aigc-metadata"],
    "download_url": "https://s3.identifai.example.com/bucket/path/to/watermarked-asset.png?X-Amz-Signature=12345",
    "expires_at": "2026-08-28T15:30:00Z"
  }
}

Authorizations

X-Api-Key

string

header

required

Path Parameters

string

required

The submission identifier returned by POST /api/v2/watermark.

Response

Submission found. Returns its current status and, when available, the watermarking result.

string

required

Identifier of the watermarking submission. Use it to poll GET /api/v2/watermark/{id}.

status

enum<string>

required

Current status of the submission. result is populated only once the status is done.

Available options:

new,

inprogress,

done,

errored

result

object | null

required

Watermarking result. null while the submission is still being processed; populated once status is done.

Show child attributes

watermarks_errors

string[]

Submission-level errors raised while preparing the watermarking job. Absent when there are none.

API v2 Documentation

Submissions

Tampering Detection

Watermarking

Get watermark result

Example request

Authorizations

Path Parameters

Response

​Example request

Authorizations

Path Parameters

Response

Example request