> ## Documentation Index
> Fetch the complete documentation index at: https://docs.belio.co.ke/llms.txt
> Use this file to discover all available pages before exploring further.

# List Services

> Retrieve a list of available messaging services

<Note>
  Refer to [Authentication](/authentication) for information on how to obtain a
  bearer token. This endpoint requires the `service.list` API client
  authorization scope to access the list of services. You can set up scopes on
  the [API Clients](https://cloud.belio.co.ke/team-overview/api-access-keys)
  page.
</Note>

### Rate Limit

This endpoint is rate limited to **1** request per second.


## OpenAPI

````yaml GET /service
openapi: 3.1.0
info:
  title: Belio API
  description: OpenAPI Specification for Belio's REST API
  contact:
    name: Belio API Support
    url: https://belio.co.ke
  version: 1.0.0
servers:
  - url: https://api.belio.co.ke
    description: API Server
security:
  - bearerAuth: []
paths:
  /service:
    get:
      tags:
        - Service
      description: Retrieve a list of available messaging services
      operationId: listServices
      responses:
        '200':
          description: List of available messaging services
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServicesResponse'
        '401':
          description: Unauthenticated - invalid credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '403':
          description: Unauthorized - Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '404':
          description: Not Found - the requested resource does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '429':
          description: Rate limit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
components:
  schemas:
    ServicesResponse:
      type: object
      properties:
        desc:
          type: object
          description: The response
          properties:
            result:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    description: Unique identifier for the service
                  serviceName:
                    type: string
                    description: Name of the service
                  productType:
                    type: string
                    enum:
                      - SMS
                      - USSD
                      - AIRTIME
                      - DATA_BUNDLE
                      - WHATSAPP
                    description: Type of product associated with the service e.g SMS
                  teamId:
                    type: string
                    description: Identifier for the team associated with the service
                  status:
                    type: string
                    enum:
                      - Draft
                      - Active
                      - Offline
                      - Suspended
                    default: Draft
                    description: Status of the service
                  createdAt:
                    type: string
                    format: date-time
                    description: Timestamp when the service was created
                  updatedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: Timestamp when the service was last updated
    APIError:
      type: object
      properties:
        desc:
          type: string
        result:
          description: Optional structured error details.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````