---
title: "List service clients"
url: "https://nov18-dev.movespot.fyi/apis/internal-pdp-policy-access-point-api-v1-1/versions/38c51035-26bf-4e85-b665-4a699daed68a/operations/listServiceClients"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/internal-pdp-policy-access-point-api-v1-1/versions/38c51035-26bf-4e85-b665-4a699daed68a.md

# List service clients

`GET` `/internal/service-clients`

Operation ID: `listServiceClients`

Returns a paginated list of service clients using cursor pagination

## Query parameters

- `page` (object, optional) - Determines which page of the collection to retrieve.

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Internal PDP Policy Access Point API v1
  version: 1.0.2
servers:
  - url: http://authorization-pap-api.kauth.svc.cluster.local:8000/v1
    description: Konnect cluster
paths:
  /internal/service-clients:
    get:
      operationId: listServiceClients
      summary: List service clients
      description: Returns a paginated list of service clients using cursor pagination
      parameters:
        - $ref: "#/components/parameters/CursorPageQuery"
      responses:
        "200":
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PagedServiceClientResponse"
      tags:
        - Service Clients
security:
  - konnectAccessToken: []
components:
  parameters:
    CursorPageQuery:
      name: page
      description: Determines which page of the collection to retrieve.
      required: false
      in: query
      schema:
        $ref: "#/components/schemas/CursorPageParameters"
  schemas:
    PagedServiceClientResponse:
      type: object
      properties:
        meta:
          $ref: "#/components/schemas/CursorMetaPage"
        data:
          type: array
          items:
            $ref: "#/components/schemas/ServiceClientListItem"
      required:
        - meta
        - data
    CursorPageParameters:
      type: object
      properties:
        size:
          description: The number of items included per page.
          type: integer
          example: 10
        after:
          description: Cursor param specifying the page (i.e. the next page) of data
            returned.
          type: string
          example: ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
        before:
          description: Cursor param specifying the page (i.e. the previous page) of data
            returned.
          type: string
          example: ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
    CursorMetaPage:
      type: object
      properties:
        first:
          description: URI to the first page
          type: string
          format: path
        last:
          description: URI to the last page
          type: string
          format: path
        next:
          description: URI to the next page
          type: string
          format: path
          nullable: true
        previous:
          description: URI to the previous page
          type: string
          format: path
          nullable: true
        size:
          description: Requested page size
          type: number
          example: 10
      required:
        - size
        - next
        - previous
    ServiceClientListItem:
      description: A service client item in a list response
      type: object
      properties:
        id:
          description: Unique identifier of the service client
          type: string
          format: uuid
        name:
          description: Name of the service client
          type: string
        description:
          description: Description of the service client
          type: string
        created_at:
          description: Timestamp when the service client was created
          type: string
          format: date-time
        updated_at:
          description: Timestamp when the service client was last updated
          type: string
          format: date-time
      required:
        - id
        - name
        - description
        - created_at
        - updated_at
  securitySchemes:
    konnectAccessToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        The Konnect access token is meant to be used by the Konnect dashboard
        and the decK CLI authenticate with.
```
