Quick Start

Make your first TrackVision API call in 5 minutes.

Prerequisites

• A TrackVision account
• An API key (see Authentication)

Set your API key and base URL as environment variables for the examples below:

export TV_API_KEY=tv_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export TV_BASE_URL=https://api.acme.trackvision.ai/v1

---

Step 1: List Your Products

cURL

curl "$TV_BASE_URL/products" \
  -H "Authorization: Bearer $TV_API_KEY"

JavaScript

const response = await fetch(`${process.env.TV_BASE_URL}/products`, {
  headers: {
    Authorization: `Bearer ${process.env.TV_API_KEY}`,
  },
});

const data = await response.json();
console.log(data.products);

Python

import requests
import os

response = requests.get(
    f"{os.environ['TV_BASE_URL']}/products",
    headers={"Authorization": f"Bearer {os.environ['TV_API_KEY']}"},
)

data = response.json()
print(data["products"])

Response:

{
  "products": [
    {
      "id": "a1b2c3d4-...",
      "name": "Organic Cotton T-Shirt",
      "sku": "TSHIRT-001",
      "gtin": "09506000134352",
      "category": "apparel",
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 50,
    "total": 1,
    "totalPages": 1
  }
}

---

Step 2: Fetch a Single Product

Use the product id from the list response:

cURL

curl "$TV_BASE_URL/products/a1b2c3d4-..." \
  -H "Authorization: Bearer $TV_API_KEY"

JavaScript

const productId = "a1b2c3d4-...";
const response = await fetch(`${process.env.TV_BASE_URL}/products/${productId}`, {
  headers: {
    Authorization: `Bearer ${process.env.TV_API_KEY}`,
  },
});

const product = await response.json();
console.log(product);

Python

product_id = "a1b2c3d4-..."
response = requests.get(
    f"{os.environ['TV_BASE_URL']}/products/{product_id}",
    headers={"Authorization": f"Bearer {os.environ['TV_API_KEY']}"},
)

print(response.json())

---

Step 3: Fetch DPP Data

Get the full Digital Product Passport for a product:

cURL

curl "$TV_BASE_URL/products/a1b2c3d4-.../dpp" \
  -H "Authorization: Bearer $TV_API_KEY"

JavaScript

const response = await fetch(
  `${process.env.TV_BASE_URL}/products/${productId}/dpp`,
  {
    headers: { Authorization: `Bearer ${process.env.TV_API_KEY}` },
  }
);

const dpp = await response.json();
console.log(dpp.credentialSubject);

Python

response = requests.get(
    f"{os.environ['TV_BASE_URL']}/products/{product_id}/dpp",
    headers={"Authorization": f"Bearer {os.environ['TV_API_KEY']}"},
)

dpp = response.json()
print(dpp["credentialSubject"])

---

Step 4: Use the GS1 Digital Link

If your product has a GTIN, you can access the public GS1 Digital Link resolver:

https://resolver.{domain}/01/{gtin}

To retrieve the DPP as a Verifiable Credential, add the linkType query parameter:

curl "https://resolver.acme.trackvision.ai/01/09506000134352?linkType=gs1:dpp" \
  -H "Accept: application/ld+json"

This returns the signed JSON-LD Verifiable Credential without requiring authentication — it is the public-facing DPP endpoint for regulators, auditors, and consumers.

---

Next Steps

• Products API — full CRUD reference
• DPP Data — all 15 DPP categories
• GS1 DPP Overview — understand the standard