Skip to main content

Overview

The Public API lives under:

/api/public/v1

The current public API version is 1.0. The v1 in the URL is the stable route namespace.

The overview endpoint is the public API index. It returns endpoint status, auth requirements, and docs URLs. It requires an API key like the rest of the public API.

Use it when you want your integration to know what is live instead of hardcoding assumptions.

curl "https://www.dyli.io/api/public/v1/overview" \
  -H "x-api-key: $DYLI_API_KEY"

The docs live at /docs. The JSON endpoints live at /api/public/v1.

Objects that map to a DYLI page include a url field when the API has enough information to build one. Product, listing, box, Fair Drop, and digital pack rows point to the canonical drop page, for example https://www.dyli.io/drop/29022.

When a row has a token id, the public API also includes metadata_url and metadata_advanced_url where possible.

Endpoint Controls​

Each endpoint has three simple flags:

  • enabled: the endpoint is available.
  • requires_api_key: callers need a key.
  • coming_soon: the endpoint is visible in the index, but currently not supported for public API use.

Endpoint inventory lives in code. Supabase only stores overrides, so new endpoints do not need a seed row just to exist.