Get asset ID

GET /api/v1/external/public/assets

An asset represents a website or application registered in truConsent (e.g. “Main Website” or “iOS App”). You need its id — the assetId — to mount the consent banner and to query collection points.

Use your admin-scope API key and organization ID from the Platform Setup steps. Run this from your development machine or a secure backend.

---

Fetch all assets

cURL

curl -X GET "https://truapi-dev.truconsent.io/api/v1/external/public/assets" \
     -H "X-API-Key: $ADMIN_API_KEY" \
     -H "X-Org-Id: $ORGANIZATION_ID"

JavaScript

const response = await fetch(
  "https://truapi-dev.truconsent.io/api/v1/external/public/assets",
  {
    headers: {
      "X-API-Key": ADMIN_API_KEY,
      "X-Org-Id": ORGANIZATION_ID,
    },
  }
);
const { data } = await response.json();

TypeScript

interface Asset {
  id: string;
  name: string;
  asset_type: string;
  description: string;
}

const response = await fetch(
  "https://truapi-dev.truconsent.io/api/v1/external/public/assets",
  {
    headers: {
      "X-API-Key": ADMIN_API_KEY,
      "X-Org-Id": ORGANIZATION_ID,
    },
  }
);
const { data }: { data: Asset[] } = await response.json();

Python

import os
import requests

url = "https://truapi-dev.truconsent.io/api/v1/external/public/assets"
headers = {
    "X-API-Key": os.environ["ADMIN_API_KEY"],
    "X-Org-Id": os.environ["ORGANIZATION_ID"],
}
response = requests.get(url, headers=headers)
data = response.json()["data"]

PowerShell

Invoke-RestMethod -Method Get `
  -Uri "https://truapi-dev.truconsent.io/api/v1/external/public/assets" `
  -Headers @{
    "X-API-Key" = $env:ADMIN_API_KEY
    "X-Org-Id"  = $env:ORGANIZATION_ID
  }

---

Sample response

{
  "data": [
    {
      "asset_type": "Web App",
      "name": "Main Website",
      "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "description": "Primary customer-facing web application"
    },
    {
      "asset_type": "Mobile App",
      "name": "iOS App",
      "id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "description": "Production iOS application"
    }
  ],
  "count": 2
}

Copy the id of the asset that matches your integration target — this is your assetId.

---

Responses

200 OK

Returns a list of all assets registered to your organization.

{
  "data": [
    {
      "asset_type": "Web App",
      "name": "Main Website",
      "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "description": "Primary customer-facing web application"
    },
    {
      "asset_type": "Mobile App",
      "name": "iOS App",
      "id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "description": "Production iOS application"
    }
  ],
  "count": 2
}

Field	Description
id	Asset UUID — use this as assetId in the SDK and collection point queries.
name	Human-readable name set in the dashboard.
asset_type	One of Web App, Mobile App, or API.
description	Optional description entered in the dashboard.
count	Total number of assets returned.

401 Unauthorized

Missing or invalid X-API-Key:

{ "detail": "Invalid or inactive API key" }

403 Forbidden

API key does not have the admin scope:

{ "detail": "API key does not have the required scope" }

Domain not on the allowed list:

{ "detail": "Origin not allowed" }

Tip

Run this query once during setup. Copy the id value and store it as a constant in your app config — it does not change unless you delete and re-create the asset in the dashboard.

---

Result

ASSET_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

---

← Consent Banner overviewNext: Get collection point ID →