/artworks
Browse the public rights-cleared artwork catalog.
Public
RELICT API · v1.3.16
Art intelligence, delivered through one API.
Access the public catalog, canonical registry evidence, rights-aware observed market facts, comparable sales, immutable artist indices, research valuation and audited exports through one versioned contract.
Public catalog without keyScoped bearer accessField-level rightsWeighted Units
Quick start
Start with the public status endpoint, then move to scoped bearer access.
1
Verify the contract
Read status and OpenAPI without a key.
2
Issue a scoped key
Create an API client inside an organization workspace.
3
Call entitled resources
Usage is metered only after auth and scope checks pass.
curl --request GET \
'https://relict.cloud/api/v1/status' \
--header 'Accept: application/json'{
"product": "RELICT API",
"version": "1.3.16",
"status": "operational",
"as_of": "<UTC timestamp>"
}Authentication
Commercial registry and intelligence routes use a bearer key with explicit scopes.
curl --request GET \
'https://relict.cloud/api/v1/registry/search?q=monet' \
--header 'Authorization: Bearer relict_live_…' \
--header 'Accept: application/json'Security contract
Keys are shown once.
Server-side storage keeps hashes, not retrievable cleartext keys. Unauthorized and scope-denied requests are rejected before endpoint Units are charged.
ScopesQuotasIP controlsAudit logs
Core endpoints
These routes are taken from the current `/api/v1` contract — no placeholder `/advisor` or `/valuations` endpoints.
/registry/search
Search canonical registry records with scoped API access.
Bearer + scope
/registry/artworks/{uuid}/evidence
Read field-level source, confidence and rights evidence.
Bearer + scope
/intelligence/artworks/{uuid}/sales
Observed sale facts available to the caller’s entitlement boundary.
Bearer + scope
/intelligence/artworks/{uuid}/comparables
Rank comparable observed sales without turning the score into a valuation.
Bearer + scope
/intelligence/artists/{uuid}/index
Read immutable artist-index builds and evidence.
Bearer + scope
/intelligence/artworks/{uuid}/valuation/research
Run research/demo valuation with explicit evidence and cannot-value states.
Bearer + scope
/exports
Create rights-aware audited exports for entitled clients.
Bearer + scope
OpenAPI client generation
No fictional npm/Python package names.
OpenAPI 3.1
Generate a typed client with the tooling your stack already trusts.
https://relict.cloud/api/v1/openapi.jsonOfficial SDK status
No official RELICT SDK package is published in this release. The API contract is the canonical integration surface.
contract: v1.3.16Webhooks
Configured per organization API client.
signed HTTP delivery
organization-scoped configuration
revoke from workspace or admin console
audited delivery state
RELICT Units
Weighted endpoint usage from the current runtime configuration.
search
1 unit per accepted request.
artist.basic
1 unit per accepted request.
artwork.basic
1 unit per accepted request.
artwork.evidence
2 units per accepted request.
sales.list
3 units per accepted request.
artist.index
4 units per accepted request.
market.analytics
5 units per accepted request.
comparables
8 units per accepted request.
export.create
10 units per accepted request.
export.status
1 unit per accepted request.
export.download
1 unit per accepted request.
asset.grant
2 units per accepted request.
visual.similarity
10 units per accepted request.
valuation.ai
20 units per accepted request.
The API does not widen the rights of its source data.
Public, research and licensed-commercial facts remain separated by data-use policy. Observed sale facts stay distinct from modeled estimates and artist indices, with source, as-of, confidence and methodology evidence where the contract exposes them.