---
title: "Listings"
method: GET
path: "/api/v1/admin/listings"
---

# Listings

`GET /api/v1/admin/listings`

## 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/admin/listings`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

Every operator with its centres: rung, what is online, how old the
oldest fact is, and the last contact.

## Response `200`

Successful Response

- AdminListingOperator[]
  - `id` string, uuid, required
  - `business_name` string, required
  - `slug` string, required
  - `website` string, nullable, required
  - `company_email` string, nullable, required
  - `legal_name` string, nullable, required
  - `company_phone` string, nullable, required
  - `publishes_public_prices` boolean, required
  - `legal_form` string, nullable
  - `vat_number` string, nullable
  - `hq_address` string, nullable
  - `hq_city` string, nullable
  - `manages_listing` boolean, required
  - `import_key` string, nullable, required
  - `kyc_state` string, required
  - `admin_approved` boolean, required
  - `terms_accepted` boolean, required
  - `opted_out` boolean, required
  - `removed_at` string, date-time, nullable
  - `removal_kind` string, nullable
  - `missing` string[], required
  - `last_contact_on` string, date, nullable, required
  - `last_contact_outcome` string, nullable, required
  - `stage` string, required
  - `sites` AdminListingSite[], required
    - `id` string, uuid, required
    - `name` string, required
    - `city` string, required
    - `address_line` string, required
    - `public_path` string, required
    - `listing_rung` integer, required
    - `published` boolean, required
    - `prenotified_at` string, date-time, nullable, required
    - `public_from` string, date, nullable, required
    - `oldest_checked_on` string, date, nullable, required
    - `import_key` string, nullable, required
    - `category` string, required
    - `postcode` string, nullable, required
    - `province` string, nullable, required
    - `phone` string, nullable, required
    - `website` string, nullable, required
    - `source_kind` string, nullable, required
    - `source_url` string, nullable, required
    - `checked_on` string, date, nullable, required
    - `district` string, nullable
    - `opening_soon` boolean
    - `opening_hours` OpeningHours: When a centre is staffed and when a customer can get in (0017). `None` and `[]` are different answers and the difference is the point: `office: None` means the operator does not publish office hours, `office: []` means there are no fixed ones — by appointment, or no staffed office. A card that turns "we do not know" into "closed" says something false about a real business.
      - `office` OpeningInterval[], nullable
        - `days` integer[], required
        - `opens` string, required
        - `closes` string, required
      - `access` OpeningInterval[], nullable
        - `days` integer[], required
        - `opens` string, required
        - `closes` string, required
      - `access_24_7` boolean
    - `hours_source_url` string, nullable
    - `amenities` string[]
    - `declared_min_m2` number, nullable
    - `declared_max_m2` number, nullable
    - `price_unit` string
    - `min_term_months` integer
    - `price_count` integer
    - `address_change` AddressChange: A new address waiting for an admin, as the operator's page and the admin's read it.
      - `address_line` string, required
      - `city` string, required
      - `postcode` string, nullable
      - `province` string, nullable
      - `lat` number, required
      - `lng` number, required
      - `requested_at` string, date-time, required

---

[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)