---
title: "ReadInstalledItems"
method: GET
path: "/v1/services/"
tags: ["services"]
---

# ReadInstalledItems

`GET /v1/services/`

List installed services and their status.

## Query parameters

- `id` integer
- `name` string
- `nature` string
- `type` string
- `pageNumber` integer
- `itemsPerPage` integer
- `sortBy` string
- `sortDirection` string
- `lastSeenId` string

## Response `200`

OK

- DtoReadInstalledServicesItemsResponse
  - `installedServices` EntityInstalledService[]
    - `autoRestart` boolean
    - `autoStart` boolean
    - `avatarUrl` string
    - `createdAt` integer
    - `envs` string[]
    - `execUser` string
    - `logErrorPath` string
    - `logOutputPath` string
    - `maxStartRetries` integer
    - `name` string
    - `nature` 'solo' | 'multi' | 'custom'
    - `portBindings` ValueObjectPortBinding[]
      - `port` integer
      - `protocol` string
    - `startCmd` string
    - `startupFile` string
    - `status` string
    - `timeoutStartSecs` integer
    - `type` 'system' | 'database' | 'runtime' | 'webserver' | 'other'
    - `updatedAt` integer
    - `version` string
    - `workingDirectory` string
  - `installedServicesWithMetrics` DtoInstalledServiceWithMetrics[]
    - `autoRestart` boolean
    - `autoStart` boolean
    - `avatarUrl` string
    - `createdAt` integer
    - `envs` string[]
    - `execUser` string
    - `logErrorPath` string
    - `logOutputPath` string
    - `maxStartRetries` integer
    - `metrics` ValueObjectServiceMetrics
      - `cpuUsagePercent` number
      - `memUsagePercent` number
      - `pids` integer[]
      - `uptimeSecs` integer
    - `name` string
    - `nature` 'solo' | 'multi' | 'custom'
    - `portBindings` ValueObjectPortBinding[]
      - `port` integer
      - `protocol` string
    - `startCmd` string
    - `startupFile` string
    - `status` string
    - `timeoutStartSecs` integer
    - `type` 'system' | 'database' | 'runtime' | 'webserver' | 'other'
    - `updatedAt` integer
    - `version` string
    - `workingDirectory` string
  - `pagination` GithubComGoinfiniteTkSrcDomainDtoPagination
    - `itemsPerPage` integer
    - `itemsTotal` integer
    - `lastSeenId` string
    - `pageNumber` integer
    - `pagesTotal` integer
    - `sortBy` string
    - `sortDirection` string

---

[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/revisions/7320a5d8ef9e/schema)