Verify a token: is this membership card (or event registration) active right now?

GET

/v1/verify/{card_token}

curl --request GET \
  --url https://api.vimine.network/v1/verify/example

• Vimine API

Privacy-preserving: returns only the status and, when active, the validity end. Never the member, the association or the statuto version. The token is verified cryptographically first (signature, validity window), then against the live membership. An event registration token (kind: registration) answers with the registration status and the event slug + start — no person.

Parameters

Path Parameters

card_token

required

The vmt_… token read from the card QR

string

Responses

200

Verification

Media typeapplication/json

object

status

required

string

Allowed values: active inactive

valid_until

string format: date-time

valid_from

With reason: not_yet_valid: the card is genuine and active, and becomes usable at this moment

string format: date-time

reason

string

Allowed values: expired invalid not_yet_valid

kind

Present for registration tokens

string

Allowed values: card registration

event

object

slug

string

starts_at

string format: date-time

Example

{
  "status": "active",
  "reason": "expired",
  "kind": "card"
}

400

Invalid request

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Not found

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

429

Rate limited

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Internal error

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}