Skip to main content
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

serviceId
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": []
  }
}
service
object
The full service object for the requested ID.

Error Responses

StatusMessageCondition
404 Not FoundService 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.