---
title: "Operator Verification"
method: GET
path: "/api/v1/me/operator/verification"
---

# Operator Verification

`GET /api/v1/me/operator/verification`

## Request

- Base URL: `https://trovastorage.it` (the document declares no server; this is the origin it was published from)
- URL: `https://trovastorage.it/api/v1/me/operator/verification`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

The status card: where the verification of the business stands, what is
still missing, and the centres waiting in a claim. The same for the owner
and for a member; it names no admin and masks the owner's address.

## Response `200`

Successful Response

- OperatorVerification: The status card of an operator's workspace: where the verification of the business stands and what, if anything, the operator must do. It names no admin, and the owner's address is masked: every member reads it.
  - `state` string, required
  - `kyb_level` integer, required
  - `next_action` VerificationAction, required
    - `kind` string, required
    - `claim_id` string, uuid, nullable
  - `expected_days` integer, required
  - `contact_email` string, required
  - `claims` VerificationClaim[], required
    - `id` string, uuid, required
    - `source_operator_name` string, required
    - `status` string, required
    - `proof_method` string, nullable, required
    - `sites` ClaimSiteOut[], required
      - `site_id` string, uuid, required
      - `name` string, required
      - `city` string, required
      - `status` string, required
    - `reason_code` string, nullable, required
    - `reason_text` string, nullable
    - `decision_note` string, nullable, required
  - `terms` VerificationTerms, required
    - `accepted` boolean, required
    - `version` string, required
    - `accepted_by` string, nullable, required
    - `accepted_at` string, date-time, nullable, required
    - `outdated` boolean
    - `effective_from` string, date, nullable
    - `grace_until` string, date, nullable
    - `summary` string, nullable
    - `upcoming` VerificationTermsUpcoming: A version announced and not yet in force, which the operator may already accept.
      - `version` string, required
      - `effective_from` string, date, nullable, required
      - `summary` string, nullable
  - `missing` string[], required
  - `reason_code` string, nullable, required
  - `reason_text` string, nullable
  - `reason_hint` string, nullable
  - `decision_note` string, nullable, required
  - `more_info_note` string, nullable
  - `proof` VerificationProof: The code an operator has to type, as the card shows it. The address is masked: every member reads the card.
    - `claim_id` string, uuid, required
    - `method` string, required
    - `state` string, required
    - `sent_to` string, nullable, required
    - `sent_at` string, date-time, nullable, required
    - `expires_at` string, date-time, nullable, required
    - `attempts_left` integer, required
  - `first_site_id` string, uuid, nullable, required
  - `suspended` VerificationSuspension, required: Why the account is suspended, as the operator reads it, and where to contest it (Regulation (EU) 2019/1150, article 4).
    - `since` string, date-time, required
    - `statement` string, required
    - `reason_code` string, nullable
    - `termination_on` string, date, nullable
    - `complaints_email` string
  - `correction` VerificationCorrection: What the operator is asked to give again, with what is on file for it. Never the VAT number.
    - `fields` string[], required
    - `note` string, required
    - `requested_at` string, date-time, required
    - `values` object, required
  - `pro_free_until` string, date, nullable

---

[API](https://skmtc.dev/trovastorage/apis/stock-your-inventory.md) · [All operations](https://skmtc.dev/trovastorage/apis/stock-your-inventory/llms.txt) · [OpenAPI document](https://skmtc.dev/trovastorage/apis/stock-your-inventory/revisions/c75f591a585c?raw)
