GET /status

GEThttps://verify.web3.market/statusLicense Key60 requests/min

Retrieve detailed information about a license key, including its status, associated product, activated domains, and usage statistics.

Query Parameters

Parameter	Type	Description
`license_key`*	string	The license key to retrieve status for. `Example: LIC-A3F9-K2M7-P8X1-Q4R6`

Example Request

curl "https://verify.web3.market/status?license_key=LIC-A3F9-K2M7-P8X1-Q4R6"

Success Response

Status: 200 OK

{
  "success": true,
  "license": {
    "key": "LIC-A3F9-K2M7-P8X1-Q4R6",
    "status": "active",
    "product": {
      "id": 42,
      "title": "DeFi Dashboard Pro",
      "slug": "defi-dashboard-pro"
    },
    "domain": {
      "domain": "app.example.com",
      "activated_at": "2026-01-15T10:30:00Z",
      "verification_count": 1247,
      "last_verified_at": "2026-02-20T08:15:32Z"
    },
    "verification_count": 1247,
    "last_verified_at": "2026-02-20T08:15:32Z",
    "expires_at": null,
    "created_at": "2026-01-10T09:00:00Z"
  }
}

Response Fields

Field	Type	Description
`key`	string	The license key
`status`	string	Current status: `active`, `suspended`, `revoked`, or `expired`
`product.id`	integer	Internal product identifier
`product.title`	string	Product display name
`product.slug`	string	Product URL slug
`domain`	object\|null	The currently activated domain, or `null` if no domain is active
`domain.domain`	string	The activated domain
`domain.activated_at`	string	ISO 8601 timestamp of when the domain was activated
`domain.verification_count`	integer	Number of times this domain has been verified
`domain.last_verified_at`	string\|null	ISO 8601 timestamp of the last verification for this domain
`verification_count`	integer	Total verification count
`last_verified_at`	string\|null	ISO 8601 timestamp of the most recent verification
`expires_at`	string\|null	ISO 8601 expiration timestamp, or `null` for perpetual licenses
`created_at`	string	ISO 8601 timestamp of when the license was created

Error Response

Invalid License Key

Status: 404 Not Found

{
  "success": false,
  "error": "invalid_key",
  "message": "The provided license key does not exist."
}

Use Cases

The status endpoint is useful for building license management interfaces:

Admin dashboards — Display license details, activated domains, and verification statistics to the license holder.
Domain management — Show the currently activated domain and offer options to deactivate or switch to a different domain.
Usage monitoring — Track verification counts and last-verified timestamps to understand how actively the license is being used.
Expiration tracking — Check the expires_at field to warn users about upcoming expirations.

The status endpoint returns data about the license regardless of its status. Even suspended, revoked, and expired licenses will return their full details. This allows you to display the reason a license is not passing verification.

POST /deactivate Webhooks