---
title: "List services"
method: GET
path: "/services"
tags: ["Services"]
---

# List services

`GET /services`

Retrieve a paginated list of services.

**gigstack Connect:** Access other teams' services using the `team` parameter.

## Query parameters

- `team` string
- `limit` integer
- `next` string, nullable
- `order_by` 'name' | 'timestamp'
- `sort` 'asc' | 'desc' — Sort direction for list queries
- `created[gte]` union
  - integer
  - string, date
- `created[lte]` union
  - integer
  - string, date

## Response `200`

Services retrieved successfully

- object
  - `message` string
  - `data` ApiPublicService[]
    - `id` string, nullable — Unique service identifier
    - `description` string, nullable — Service description
    - `from` string, nullable — Source of service creation
    - `sku` string, nullable — Stock Keeping Unit identifier
    - `product_key` string, nullable — SAT product key for tax compliance
    - `unit_key` string, nullable — SAT unit key for tax compliance
    - `unit_name` string, nullable — Unit name for the service
    - `unit_price` number, nullable — Price per unit
    - `taxes` TaxElement[], nullable — Tax configuration for this service
      - `base` union — Taxable base amount. Accepts number or numeric string. If null, calculated automatically from item price.
        - number
        - string
      - `factor` string, nullable — SAT tax factor (Tasa, Cuota, Exento)
      - `inclusive` boolean, nullable — Whether the tax is included in the unit price
      - `rate` number, required — Tax rate (e.g., 0.16 for 16% IVA)
      - `type` 'IVA' | 'ISR' | 'IEPS', required — Type of tax
      - `withholding` boolean, nullable — Whether this is a withholding tax
    - `team` string, required — Team ID this service belongs to
    - `created_at` number, required — Unix timestamp of service creation
    - `quantity` number, nullable — Quantity (used in transactions)
  - `has_more` boolean
  - `total_results` integer
  - `next` string, nullable

---

[API](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/revisions/5cf53ffd7580/schema)