---
title: "Retrieve user services"
method: POST
path: "/kvm/v2/get/services"
---

# Retrieve user services

`POST /kvm/v2/get/services`

Retrieves a list of services linked to the user's account based on the provided login credentials, including details such as service status, billing cycle, pricing, and location.

## Request body

- object
  - `email` string — Your WHMCS email address.
  - `pw` string — Your WHMCS password.

## Response `200`

Successful response

- GetServicesResponse200
  - `status` string — Request status. Returns `success` when the request was processed correctly.
  - `services` ServiceItem[] — List of services linked to the authenticated account. Returns an empty array if no services exist. ⚠️ **To view detailed descriptions for each service field, click “Show child attributes” below.**
    - `service_id` integer — Unique WHMCS service identifier for the VPS.
    - `kvm_id` string — EDIS KVM instance identifier.
    - `status` 'active' | 'suspended' | 'terminated' — Service lifecycle status. Possible values: `active`, `suspended`, `terminated`.
    - `price` object — Structured pricing information for the service.
      - `billingcycle` string — Billing cycle of the service.
      - `amount` string — Recurring price amount.
      - `currency` string — Currency of the service price.
    - `creation_date` string, date — Creation date of the VPS.
    - `key_date` string, date — Next invoice due date for this service.
    - `paymentmethod` string — Payment method assigned to the service.
    - `plan` string — Product/plan name of the VPS.
    - `location` string — VPS hosting location.

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized - Invalid WHMCS credentials.
- `500` — Server error

---

[API](https://skmtc.net/edisglobal/apis/edis-global-management-api.md) · [All operations](https://skmtc.net/edisglobal/apis/edis-global-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/edisglobal/edis-global-management-api/versions/223263c91ac0/schema)