GET /api/v1/services — List All Retempo Services

Use this endpoint to retrieve all services registered in your Retempo account. The response is an array of service objects ordered by createdAt descending, so your most recently created service always appears first. Each object includes the full owner details and all associated payment plans — the same fields returned by the Get Service endpoint.

GET https://api.retempo.xyz/api/v1/services

Request Parameters

This endpoint accepts no query parameters and no request body. Send the request as a plain GET with no payload.

Response

A successful request returns HTTP 200 OK with a services array. If no services exist, the array is empty.

{
  "services": [
    {
      "id": "clz1abc2def3ghi4",
      "name": "DataStream Pro",
      "description": "Real-time data streaming API",
      "status": "ACTIVE",
      "ownerId": "clz1owner123",
      "createdAt": "2025-06-01T10:00:00.000Z",
      "updatedAt": "2025-06-01T10:00:00.000Z",
      "owner": {
        "id": "clz1owner123",
        "email": "dev@example.com",
        "name": "Alice Dev",
        "role": "DEVELOPER"
      },
      "paymentPlans": []
    }
  ]
}

array

An array of service objects, ordered by createdAt descending.

Show service object fields

string

The unique identifier for the service.

string

The display name of the service.

string

The service description, if one was provided at creation.

string

The current lifecycle status of the service: DRAFT, ACTIVE, or DISABLED.

string

The ID of the user who owns this service.

string

ISO 8601 timestamp recording when the service was created.

string

ISO 8601 timestamp recording when the service was last modified.

object

The full owner user object, including id, email, name, and role.

array

All payment plans attached to this service. Each element contains plan details such as pricingType, amount, billingInterval, and currency.

Example

curl https://api.retempo.xyz/api/v1/services

Example response:

{
  "services": [
    {
      "id": "clz1abc2def3ghi4",
      "name": "DataStream Pro",
      "description": "Real-time data streaming API",
      "status": "ACTIVE",
      "ownerId": "clz1owner123",
      "createdAt": "2025-06-01T10:00:00.000Z",
      "updatedAt": "2025-06-01T10:00:00.000Z",
      "owner": {
        "id": "clz1owner123",
        "email": "dev@example.com",
        "name": "Alice Dev",
        "role": "DEVELOPER"
      },
      "paymentPlans": []
    }
  ]
}

Overview

Services

Payment Plans

Checkout & Invoicing

Settlements

GET /api/v1/services — List All Retempo Services

Request Parameters

Response

Example

​Request Parameters

​Response

​Example

Request Parameters

Response

Example