Authentication

Most endpoints accept anonymous requests with a low rate limit. Sign in with Discord at darkerdb.com to issue an API key for higher quotas.

API key

Pass the key in the X-Api-Key header:

curl https://api.darkerdb.com/v2/items \
   -H "X-Api-Key: dd_xxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"

Keys are scoped to your DarkerDB account and to the permissions you delegate at issuance time. They cannot exceed your own permissions.

Rate limits

Every response includes the standard rate-limit headers:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 597
X-RateLimit-Reset: 1735689600

A 429 Too Many Requests response includes a Retry-After: <seconds> header.

See Rate limits for the per-tier quotas.