DKBSignDocs

API reference

GETRequires Bearer token

Introspect the current token

/api/v1/check-auth-token

Validate the Bearer token and return the current user (company modules, role, license). 403 LICENSE_EXPIRED when the company license blocks access.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

This endpoint does not accept a request body.

Responses

StatusMeaning
202Token is valid
401Missing or invalid Bearer token.

Request

curl
curl -X GET 'https://api.dkbsigns.com/api/v1/check-auth-token' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN'

Response 202

json
{
  "message": "Valid authentication token",
  "data": {
    "user": {
      "id": 4,
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "user@acme.test",
      "role": "user",
      "company_id": 1,
      "job_title": "Chief Financial Officer",
      "locale": "fr",
      "seal": null,
      "signature_mentions": {
        "enabled": true,
        "frame": false,
        "mentions": [
          "fullName",
          "jobTitle"
        ]
      },
      "is_available": true
    }
  }
}