---
title: "List Network Resources"
url: "https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598/operations/ResourceController_findAll"
---

> Full API specification: https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598.md

# List Network Resources

`GET` `/tenants/resources`

Operation ID: `ResourceController_findAll`

Retrieves a paginated list of all network resources for the tenant with advanced filtering and sorting capabilities. Supports filtering by resource type, gateway associations, protocols, and other criteria to help manage complex network topologies.

## Query parameters

- `sort` (string, optional) - Sort order in format "field:direction". Sortable fields: id, name. Direction: asc, desc
- `limit` (number, optional)
- `offset` (number, optional)
- `filter[policies.id]` (string, optional) - Filter resources by policy ID (UUID format)
- `filter[gateways.id]` (string, optional) - Filter resources by gateway ID (UUID format)
- `filter[addresses.protocols.id]` (string, optional) - Filter resources by protocol ID in addresses (UUID format)
- `filter[type]` (string, optional) - Filter resources by type
- `filter[name]` (string, optional) - Filter resources by name
- `filter[id]` (string, optional) - Filter resources by ID (UUID format)
- `page[offset]` (number, optional) - Number of resources to skip (minimum: 0)
- `page[limit]` (number, optional) - Number of resources to return per page (minimum: 1)

## Responses

- `200` - Successfully retrieved resources
- `401` - Unauthorized - Invalid or missing authentication token
- `403` - Forbidden - Insufficient permissions to access this resource.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Cipherscale API
  version: "1.0"
servers:
  - url: https://public-api.cipherscale.com/qa
    description: Cipherscale Public API Server
paths:
  /tenants/resources:
    get:
      operationId: ResourceController_findAll
      summary: List Network Resources
      description: Retrieves a paginated list of all network resources for the tenant
        with advanced filtering and sorting capabilities. Supports filtering by
        resource type, gateway associations, protocols, and other criteria to
        help manage complex network topologies.
      parameters:
        - name: sort
          required: false
          in: query
          description: 'Sort order in format "field:direction". Sortable fields: id, name.
            Direction: asc, desc'
          schema:
            example: -name
            type: string
        - required: false
          name: limit
          in: query
          schema:
            type: number
        - required: false
          name: offset
          in: query
          schema:
            type: number
        - name: filter[policies.id]
          required: false
          in: query
          description: Filter resources by policy ID (UUID format)
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
        - name: filter[gateways.id]
          required: false
          in: query
          description: Filter resources by gateway ID (UUID format)
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
        - name: filter[addresses.protocols.id]
          required: false
          in: query
          description: Filter resources by protocol ID in addresses (UUID format)
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
        - name: filter[type]
          required: false
          in: query
          description: Filter resources by type
          schema:
            enum:
              - PRIVATE
              - SAAS
              - INTERNET
            type: string
        - name: filter[name]
          required: false
          in: query
          description: Filter resources by name
          schema:
            example: Resource Name
            type: string
        - name: filter[id]
          required: false
          in: query
          description: Filter resources by ID (UUID format)
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
        - name: page[offset]
          required: false
          in: query
          description: "Number of resources to skip (minimum: 0)"
          schema:
            example: 0
            type: number
        - name: page[limit]
          required: false
          in: query
          description: "Number of resources to return per page (minimum: 1)"
          schema:
            example: 10
            type: number
      responses:
        "200":
          description: Successfully retrieved resources
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaginatedDto"
        "401":
          description: Unauthorized - Invalid or missing authentication token
        "403":
          description: Forbidden - Insufficient permissions to access this resource.
      tags:
        - Resources
      security:
        - ApiKeyAuth: []
security:
  - ApiKeyAuth: []
components:
  schemas:
    PaginatedDto:
      type: object
      properties: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```
