Skip to main content
GET
/
products
List products
curl --request GET \
  --url https://api.alguna.io/products \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "created_at": "2026-04-01T10:00:00Z",
      "description": "Monthly platform access fee",
      "fee_type": "fixed",
      "id": "prod_01H1VECT",
      "name": "Platform Fee",
      "payment_terms": "arrears",
      "revenue_allocation_method": "straight_line",
      "updated_at": "2026-04-01T12:30:00Z",
      "billing_frequency": "recurring",
      "metric_ids": [
        "mtr_01H2ABC"
      ],
      "sku": "PLATFORM_FEE",
      "tag_ids": [
        "tag_01H3DEF"
      ],
      "unit_label_plural": "API calls",
      "unit_label_singular": "API call"
    }
  ],
  "pagination": {
    "per_page": 20,
    "total_pages": 5
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

​
Alguna-Version
enum<string>
required
Available options:
2026-04-01

Query Parameters

​
fee_type
enum<string>[]

Filter by fee type (comma-separated to match any)

Available options:
fixed,
metered
Example:

"fixed"

​
limit
integer<int64>
required

Number of items to return per page

Example:

20

​
metric_ids
string[]

Filter by associated metric IDs (comma-separated to match any)

Example:

"mtr_01H2ABC"

​
offset
integer<int64>
required

Number of items to skip

Example:

0

​
payment_terms
enum<string>[]

Filter by payment terms (comma-separated to match any)

Available options:
advance,
arrears
Example:

"arrears"

Response

Success

​
data
object[]
required

List of products

​
pagination
object
required

Pagination metadata