---
title: "Retrieve a list of resources"
url: "https://kongair.terwilligar.com/apis/api-dcr-auth0-2-0-0/versions/b2ff7a29-69e1-48bd-bce3-5032af128fda/paths/resources/get"
---

> Full API specification: https://kongair.terwilligar.com/apis/api-dcr-auth0-2-0-0/versions/b2ff7a29-69e1-48bd-bce3-5032af128fda.md

# Retrieve a list of resources

`GET` `/resources`

Retrieves a list of resources. Requires a valid access token.

## Query parameters

- `limit` (integer, int32, optional) - Maximum number of items to return
- `offset` (integer, int32, optional) - Number of items to skip for pagination

## Responses

- `200` - Successful operation
- `401` - Unauthorized - Missing or invalid token
- `500` - Internal server error

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: DCR with Auth0 API
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: Main server
paths:
  /resources:
    get:
      summary: Retrieve a list of resources
      description: Retrieves a list of resources. Requires a valid access token.
      security:
        - bearerAuth: []
      parameters:
        - name: limit
          in: query
          description: Maximum number of items to return
          schema:
            type: integer
            format: int32
            minimum: 1
            maximum: 100
            default: 20
        - name: offset
          in: query
          description: Number of items to skip for pagination
          schema:
            type: integer
            format: int32
            minimum: 0
            default: 0
      responses:
        "200":
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResourceList"
        "401":
          description: Unauthorized - Missing or invalid token
        "500":
          description: Internal server error
security:
  - bearerAuth: []
components:
  schemas:
    ResourceList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: "#/components/schemas/Resource"
        meta:
          type: object
          properties:
            page:
              type: object
              properties:
                limit:
                  type: integer
                  description: Number of items per page
                offset:
                  type: integer
                  description: Offset from the beginning of the dataset
                total:
                  type: integer
                  description: Total number of items in the dataset
                estimated_total:
                  type: boolean
                  description: Indicates if the total is estimated
      example:
        data:
          - id: 123e4567-e89b-12d3-a456-426614174000
            name: Sample Resource
        meta:
          page:
            limit: 25
            offset: 0
            total: 1
            estimated_total: false
    Resource:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of the resource
        name:
          type: string
          description: Name of the resource
      example:
        id: 123e4567-e89b-12d3-a456-426614174000
        name: Sample Resource
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
```