Download C2PA Asset

The prerequisite of the API includes acquiring the Capture Token following the instructions and registration of the asset following the initial asset registration instructions.

In order to verify the C2PA content, you may visit the official Verify page provided by C2PA. For more details about C2PA, see the C2PA official website.

Supported File Types

Numbers C2PA API currently supports the following file types for processing:

• AVI (video/msvideo, video/avi, application-msvideo)

• AVIF (image/avif)

• C2PA (application/x-c2pa-manifest-store)

• DNG (image/x-adobe-dng)

• HEIC (image/heic)

• HEIF (image/heif)

• JPEG/JPG (image/jpeg)

• M4A (audio/mp4)

• MOV (video/quicktime)

• MP4 (video/mp4, application/mp4)

• PNG (image/png)

• SVG (image/svg+xml)

• TIFF/TIF (image/tiff)

• WAV (audio/x-wav)

• MP3 (audio/mpeg)

• WEBP (image/webp)

Special Notes

Unsupported File Types

• PDF (application/pdf): Currently not supported due to an ongoing issue.

API Endpoint: https://api.numbersprotocol.io/api/v3/assets/NID/c2pa/

Cost: 0 NUM (free to use)

Method: POST

Authentication:
This API requires a valid token for Authorization.
The token should be passed in the headers of the 
request using the following format:
"Authorization: token YOUR_CAPTURE_TOKEN"

Path parameter (required):
nid (string): Nid of the asset to download

Examples:
curl -X POST https://api.numbersprotocol.io/api/v3/assets/NID/c2pa/ \
    -H "Content-Type: application/json" \
    -H "Authorization: token YOUR_CAPTURE_TOKEN"

Response:
{
    "url": string, // URL for downloading the C2PA asset.
    "cid": string // cid of the C2PA asset. Note that because of the nature of C2PA injection, the cid will not be the same as the asset nid.
}

Python

import requests
import json

# Define the API endpoint
url = "https://api.numbersprotocol.io/api/v3/assets/{nid}/c2pa/"

# Define the headers for the request
headers = {
    "Content-Type": "application/json",
    "Authorization": "token YOUR_CAPTURE_TOKEN" # Replace YOUR_CAPTURE_TOKEN with your own
}

# Define the path parameters for the request
url = url.format(nid=NID) # Replace NID with the Nid of the asset you want to create and download C2PA file

# Send the POST request to the API endpoint
response = requests.post(url, headers=headers)

# Check the response status code
if response.status_code != 200:
    print(f"Error: {response.status_code} - {response.text}")
else:
    # Parse the JSON response
    json_data = response.json()
    download_url = json_data["url"]
    print(download_url)

Javascript

const request = require("request");

const url = "https://api.numbersprotocol.io/api/v3/assets/{nid}/c2pa/"; // Replace the {nid} with the actual nid
const headers = {
  "Content-Type": "application/json",
  "Authorization": "token YOUR_CAPTURE_TOKEN"
};

request.post(
  {
    url,
    headers
  },
  function(error, response, body) {
    console.log(body);
  }
);