---
title: "List products"
method: GET
path: "/1/products"
tags: ["Products"]
---

# List products

`GET /1/products`

This endpoint allows you to retrieve all the products where the current user's has at least one right.

## Query parameters

- `with` string
- `account_id` integer — Unique identifier of the `account` that is related to the resource `{name}`
- `customer_name` string — Customer name of the resource `{name}`
- `fqdn` string
- `internal_name` string
- `product_id` integer — Unique identifier of the `product` that is related to the resource `{name}`
- `service_id` 1 | 2 | 3 | 4 | 6 | 7 | 10 | 14 | 15 | 18 | 23 | 25 | 26 | 29 | 30 | 31 | 34 | 35 | 37 | 40 | 43 | 48 | 50 | 52 | 58 — Unique identifier of the `service` that is related to the resource `{name}`
- `service_name` 'ai_tools' | 'backup' | 'certificate' | 'cloud' | 'cloud_hd' | 'custom_url' | 'dedicated_server' | 'domain' | 'drive' | 'e_ticketing' | 'email_hosting' | 'hosting' | 'housing' | 'invitation' | 'jelastic' | 'ksuite' | 'mailing' | 'nas' | 'public_cloud' | 'radio' | 'swiss_backup' | 'video' | 'vod' | 'web_hosting' | 'website_builder' — Name of the service
- `return` 'total'
- `limit` integer
- `skip` integer
- `page` integer
- `per_page` integer
- `order_by` union
  - string
  - string[]
- `order` 'asc' | 'desc'
- `order_for` object

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadProduct[]
    - `id` integer, required — Unique identifier of the resource `Product`
    - `account_id` integer, required — Unique identifier of the `account` that is related to the resource `Product`
    - `service_id` integer, required — Unique identifier of the `service` that is related to the resource `Product`
    - `service_name` string, required — Name of the service
    - `customer_name` string, required — Customer name of the resource `Product`
    - `internal_name` string, nullable, required
    - `created_at` integer, required — Timestamp `Product` has been created
    - `expired_at` integer, nullable, required — Timestamp `Product` has expired
    - `deleted_at` integer — Timestamp `Product` has been deleted
    - `version` integer, required
    - `has_maintenance` boolean, required — Does the resource `Product` have a maintenance mode enabled?
    - `is_locked` boolean, required — Is the resource `Product` locked?
    - `has_operation_in_progress` boolean, required — Does the resource `Product` have an operation in progress ?
    - `tags` 087adaadTag[], required
      - `id` integer, required — Unique identifier of the resource `Tag`
      - `name` string, required — Name of the resource `Tag`
      - `color` integer, required
      - `product_count` integer — Product count related to the resource `Tag`
    - `unique_id` integer, required — Unique identifier of the resource `Product`
    - `description` string — Description of the resource `Product`
    - `bill_reference` string
    - `is_free` boolean, required — Does the resource `Product` have a free price status?
    - `is_zero_price` boolean, required — Does the resource `Product` have a zero price status?
    - `is_trial` boolean, required — Does the resource `Product` have a trial status?
    - `rights` 087adaadRight, required
      - `technical` boolean
      - `statistic` boolean
      - `check` boolean
      - `sale` boolean
    - `parent_id` integer
    - `parent_service_id` integer
    - `parent_service_name` string
    - `status` string — Status of the resource `Product`
    - `users` 087adaadProductUser[]
      - `user_id` integer, required
      - `rights` 087adaadRight, required
        - `technical` boolean
        - `statistic` boolean
        - `check` boolean
        - `sale` boolean
    - `admin` 087adaadProductAdminUser
      - `user_id` integer, required
      - `email` string, required — Email
      - `display_name` string, required — Display name
    - `fqdn` string
    - `is_managed_by_partner` boolean
    - `flags` unknown[]
      - unknown
    - `renew_preferences` unknown[]
      - unknown
    - `is_transferable` boolean
  - `total` integer — Total number of items Added when using query parameter `page`
  - `page` integer — Number of the current page Added when using query parameter `page`
  - `pages` integer — Total number of pages Added when using query parameter `page`
  - `items_per_page` integer — Number of items per page Added when using query parameter `page`

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)