Skip to main content
GET
/
api
/
products
List Products
curl --request GET \
  --url https://qwoty.app/api/products \
  --header 'Authorization: <authorization>'
{
  "total": 42,
  "next": "https://qwoty.app/api/products?limit=30&page=2",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
      "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
      "name": "Consulting Services - Senior",
      "api_name": "consulting_services_senior",
      "reference": "SERV-001",
      "description": "Senior consultant hourly rate",
      "description_inherit_from_product": true,
      "primary_image_inherit_from_product": true,
      "is_active": true,
      "is_default": true,
      "catalog_ids": ["770e8400-e29b-41d4-a716-446655440002"],
      "category_ids": [],
      "settings": {
        "unit_per_pack": 1,
        "product_type": "service",
        "language_id": "990e8400-e29b-41d4-a716-446655440004",
        "unit_of_measure": "hour",
        "recurrence_type": "recurring"
      },
      "shipping": {
        "weight": null,
        "weight_unit": null,
        "height": null,
        "length": null,
        "width": null,
        "length_unit": null,
        "country_of_origin": null,
        "harmonized_system_code": null
      },
      "inventory": {
        "sku": "CONS-SEN-001"
      },
      "identifiers": {
        "crm": null,
        "accounting": null,
        "erp": null
      },
      "accounting": {
        "ledger_account": null
      },
      "options": [
        {
          "option_id": "opt-001",
          "option_name": "Seniority",
          "option_api_name": "seniority",
          "value_id": "val-001",
          "value_name": "Senior",
          "value_api_name": "senior"
        }
      ],
      "prices": [
        {
          "id": "price-001",
          "pricebook_id": "pb-001",
          "pricebook_api_name": "standard"
        }
      ],
      "primary_image_id": null,
      "parent_primary_image_id": null,
      "created_at": "2024-12-21T10:30:00Z",
      "updated_at": "2024-12-21T10:30:00Z"
    }
  ]
}

​
Authorization

​
Authorization
string
required
Bearer token for authentication. Format: Bearer qwoty_your_token

​
Query Parameters

​
limit
integer
default:"30"
Number of results per page (max 200)
​
page
integer
default:"1"
Page number (1-based)
​
external_id
string
Filter by external identifier. Matches against identifiers[erp], identifiers[crm], and identifiers[accounting].
​
api_name
string
Filter by exact API name
​
sku
string
Filter by SKU (inventory[sku])
​
reference
string
Filter by internal reference

​
Examples

curl https://qwoty.app/api/products \
  -H "Authorization: Bearer qwoty_your_token"

​
Response

​
total
integer
Total number of products matching the query (across all pages)
​
next
string | null
URL to fetch the next page, or null if this is the last page
​
data
array
Array of product objects for the current page
{
  "total": 42,
  "next": "https://qwoty.app/api/products?limit=30&page=2",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
      "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
      "name": "Consulting Services - Senior",
      "api_name": "consulting_services_senior",
      "reference": "SERV-001",
      "description": "Senior consultant hourly rate",
      "description_inherit_from_product": true,
      "primary_image_inherit_from_product": true,
      "is_active": true,
      "is_default": true,
      "catalog_ids": ["770e8400-e29b-41d4-a716-446655440002"],
      "category_ids": [],
      "settings": {
        "unit_per_pack": 1,
        "product_type": "service",
        "language_id": "990e8400-e29b-41d4-a716-446655440004",
        "unit_of_measure": "hour",
        "recurrence_type": "recurring"
      },
      "shipping": {
        "weight": null,
        "weight_unit": null,
        "height": null,
        "length": null,
        "width": null,
        "length_unit": null,
        "country_of_origin": null,
        "harmonized_system_code": null
      },
      "inventory": {
        "sku": "CONS-SEN-001"
      },
      "identifiers": {
        "crm": null,
        "accounting": null,
        "erp": null
      },
      "accounting": {
        "ledger_account": null
      },
      "options": [
        {
          "option_id": "opt-001",
          "option_name": "Seniority",
          "option_api_name": "seniority",
          "value_id": "val-001",
          "value_name": "Senior",
          "value_api_name": "senior"
        }
      ],
      "prices": [
        {
          "id": "price-001",
          "pricebook_id": "pb-001",
          "pricebook_api_name": "standard"
        }
      ],
      "primary_image_id": null,
      "parent_primary_image_id": null,
      "created_at": "2024-12-21T10:30:00Z",
      "updated_at": "2024-12-21T10:30:00Z"
    }
  ]
}

​
Error Responses

{
  "error": "Invalid API token"
}