Download C2PA files

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.
}

{% tabs %} {% tab title="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)

{% tab title="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);
  }
);

{% endtab %}

Downloading C2PA Files on Mobile Devices

If you’re using Capture Dashboard or Capture Cam, you can download the C2PA file for a registered asset through the Dashboard’s asset detail page or the Capture Cam asset detail page on either desktop or mobile devices. To download C2PA files on your phone, please ensure the following:

1. The asset is registered and supports C2PA injection.
2. If your phone’s browser blocks downloads:
3. Open the browser’s Settings.
4. Navigate to Privacy or a similar option.
5. Disable any settings blocking auto-downloaded content.

For additional details on supported file types and the download process, refer to the Supported FIle Types section above.