preloder logo

DVAL REST API

API v1 gives registered sellers secure JSON access to their own listings, public portfolio totals and marketplace statistics. Write access is intentionally disabled in v1.

Authentication

Create an API key inside User Dashboard > API Access. Send both credentials with every request.

X-DVAL-API-KEY: your_api_key
X-DVAL-API-SECRET: your_api_secret

The API Secret is shown only once after creation and is stored as a secure hash.

GET

/api/v1/listings

Returns listings owned by the authenticated user only. Optional query parameters: page, limit, type, status.

GET

/api/v1/listings/{id}

Returns one listing if it belongs to the authenticated user. Unknown or foreign listings return 404.

GET

/api/v1/portfolio

Returns total listings, active listings, sold listings, drafts, portfolio value and portfolio URL.

GET

/api/v1/stats

Returns views, offers and watcher totals. Missing optional stats tables fall back to zero instead of breaking the API.

Example cURL

curl -X GET "https://dval.org/api/v1/listings" \
  -H "X-DVAL-API-KEY: your_api_key" \
  -H "X-DVAL-API-SECRET: your_api_secret"

POST, PUT and DELETE routes are reserved for future versions and currently return 501.

DVAL Support How can we help?
DVAL Bot

Hi. I can help with listings, payments, promotions, accounts and support tickets. Choose a topic or type your question.

Create support ticket If the bot cannot solve it, send the case directly to DVAL Support.