GET /api/v1/services/:serviceId — Fetch a Single Service

Use this endpoint to fetch a single service by its unique ID. The response includes the complete service object with the associated owner details and all attached payment plans. This is the best endpoint to use when you need the full service record — for example, before creating a checkout session or verifying plan configuration.

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

Path Parameters

string

required

The unique identifier of the service you want to retrieve. You receive this ID in the response body when you create a service or from the list services endpoint.

Response

A successful request returns HTTP 200 OK with the full service object.

{
  "service": {
    "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": []
  }
}

object

The full service object for the requested ID.

Show service 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: 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 including pricingType, amount, billingInterval, and currency.

Error Responses

Status	Message	Condition
`404 Not Found`	`Service was not found.`	No service exists for the provided `serviceId`.

Example

Replace clz1abc2def3ghi4 with your actual service ID:

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

Example response:

{
  "service": {
    "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": []
  }
}

Example 404 response:

{
  "error": "Service was not found."
}

Service IDs are case-sensitive. Passing an ID with incorrect casing returns a 404 even if a service with a similar ID exists.

Overview

Services

Payment Plans

Checkout & Invoicing

Settlements

GET /api/v1/services/:serviceId — Fetch a Single Service

Path Parameters

Response

Error Responses

Example

​Path Parameters

​Response

​Error Responses

​Example

Path Parameters

Response

Error Responses

Example