---
title: "Lists endpoints that received no requests"
method: GET
path: "/apiops/projects/{projectName}/reports/inactive-endpoints"
tags: ["ProjectReports"]
---

# Lists endpoints that received no requests

`GET /apiops/projects/{projectName}/reports/inactive-endpoints`

## Request

- Base URL: `http://167.86.118.166:32080`
- URL: `http://167.86.118.166:32080/apiops/projects/{projectName}/reports/inactive-endpoints`
- Auth: none declared
- TypeScript: <https://skmtc.dev/apinizer/apis/apinizer-management-apis/docs/apiops/projects/:projectName/reports/inactive-endpoints/get.ts> (a function with typed inputs; its response is checked against the schema)

Every endpoint of the project's API proxies with the requests it served in the period, so the unused ones can be found. An endpoint carries its HTTP method, which is what tells GET /pet from POST /pet; SOAP operations and the method-less proxy kinds (reverse proxy, mirror, connector) answer httpMethod=null and endpoint="/". Pass maxUsage=0 for the strictly unused ones. counts.total=0 means no request inside the retained traffic log, NOT necessarily never called - read coverage.dataAvailableFrom before retiring an API.

## Path parameters

- `projectName` string, required

## Query parameters

- `environmentName` string, required
- `from` string
- `to` string
- `apiProxyName` string
- `minUsage` integer
- `maxUsage` integer
- `page` integer
- `size` integer
- `sort` string

## Response `200`

successful operation!

- ApiOpsPagedInactiveEndpointsResponse
  - `status` 'SUCCESS' | 'FAILURE'
  - `items` ApiOpsResponseInactiveEndpoint[]
    - `apiProxyName` string: Name of the API proxy that owns the endpoint.
    - `httpMethod` string: HTTP method of the endpoint; null for SOAP operations and method-less proxies.
    - `endpoint` string: Endpoint path as defined on the proxy; "/" for a proxy that has no methods.
    - `counts` Counts
      - `success` integer
      - `blocked` integer
      - `error` integer
      - `total` integer
  - `page` integer
  - `size` integer
  - `totalElements` integer
  - `totalPages` integer
  - `sort` string[]
  - `coverage` Coverage
    - `dataAvailableFrom` string, date-time: Oldest traffic log record inside this scope; null when the log holds none.
    - `warning` string: Set when the requested range is not fully covered by the traffic log.
    - `retentionDays` integer: Traffic log retention in days, when a delete phase is configured.

## Other responses

- `401`: not authorized for this operation!
- `500`: internal error!

## Changes

- **2026-09-12** `90cf59a80235`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apinizer/apis/apinizer-management-apis/changes/apiops/projects/:projectName/reports/inactive-endpoints/get.md)

---

[API](https://skmtc.dev/apinizer/apis/apinizer-management-apis.md) - [All operations](https://skmtc.dev/apinizer/apis/apinizer-management-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/apinizer/apis/apinizer-management-apis/revisions/e083046b24cd?raw)