viewa/docs
API Reference

List your registered SKU aliases

GET
/aliases

The audit of every SKU your instance has registered, oldest first. Secret key only: it enumerates your whole SKU map, which a browser never needs. Register, repoint and remove aliases with PUT and DELETE /aliases/{sku}; registrations made in the Viewa CMS admin appear here too. Never cached: a SKU you have just registered must be visible here on the next request.

Authorization

secretKey
AuthorizationBearer <token>

Secret key (server-side only), sent as Authorization: Bearer sk_…. This is the higher API-key tier: it satisfies routes requiring either the pk or sk tier. On pk-level routes no Origin header is required, and any forwarded Origin is ignored. The secret key satisfies the API-key tier only; it does not bypass visitor-token requirements, instance scoping, quotas or metering, or any other route-specific authorization. Routes requiring the sk tier remain secret-key-only, including administrative surfaces such as SKU alias registration, the origin allowlist, usage, and visitor deletion.

In: header

Query Parameters

page?integer

1-based page number.

Range1 <= value
Default1
limit?integer

Items per page.

Range1 <= value <= 100
Default20
collection?string

Restrict the audit to aliases targeting one collection.

Value in

  • "products"
  • "materials"
  • "material-sets"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/aliases"
{  "data": [    {      "sku": "ELITE-ROLLER-01",      "collection": "products",      "target": {        "id": "prod_3xK9aQ0ZbW7mNc2LpRvT",        "name": "Elite Roller Blind"      },      "material": {        "id": "mat_8hT3kW1qZr6YbN0cVxLp",        "name": "Sandstone"      },      "createdAt": "2026-08-20T04:11:07.512Z"    }  ],  "pagination": {    "page": 1,    "limit": 1,    "totalItems": 0,    "totalPages": 0  }}