---
title: "ReadVirtualHostsWithMappings"
method: GET
path: "/v1/vhost/mapping/"
tags: ["vhosts"]
---

# ReadVirtualHostsWithMappings

`GET /v1/vhost/mapping/`

List virtual hosts with mappings.

## Query parameters

- `hostname` string
- `type` string
- `rootDirectory` string
- `parentHostname` string
- `withMappings` boolean
- `createdBeforeAt` integer
- `createdAfterAt` integer
- `pageNumber` integer
- `itemsPerPage` integer
- `sortBy` string
- `sortDirection` string
- `lastSeenId` string

## Response `200`

OK

- DtoVirtualHostWithMappings
  - `aliasesHostnames` string[]
  - `createdAt` integer
  - `hostname` string
  - `isPrimary` boolean
  - `isWildcard` boolean
  - `mappings` EntityMapping[]
    - `createdAt` integer
    - `hostname` string
    - `id` integer
    - `mappingSecurityRuleId` integer
    - `marketplaceInstalledItemId` integer
    - `marketplaceInstalledItemName` string
    - `matchPattern` 'begins-with' | 'contains' | 'equals' | 'ends-with'
    - `path` string
    - `shouldUpgradeInsecureRequests` boolean
    - `targetHttpResponseCode` integer
    - `targetType` 'url' | 'service' | 'response-code' | 'inline-html' | 'static-files'
    - `targetValue` string
    - `updatedAt` integer
  - `parentHostname` string
  - `rootDirectory` string
  - `type` 'top-level' | 'subdomain' | 'alias' | 'wildcard' | 'primary'

---

[API](https://skmtc.net/goinfinite/apis/osapi.md) · [All operations](https://skmtc.net/goinfinite/apis/osapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goinfinite/osapi/versions/7320a5d8ef9e/schema)