List

GET/products

Lists all products for the workspace

ReturnsExpand Collapse

data: array of object { id, code, created, 5 more }

id: string

Unique identifier for the product

code: string

User-defined product identifier.

created: string

ISO 8601 timestamp when the product was created

formatdate-time

description: string

Description of the product

paid_by_roles: array of object { id, name }

User roles that can pay for this product

id: string

The unique ID of the role

name: string

The name of the role

paid_to_roles: array of object { id, name }

User roles that receive payment for this product

id: string

The unique ID of the role

name: string

The name of the role

updateVersion: number

Version number for optimistic locking

workspaceId: string

Workspace ID this product belongs to

List

curl https://api.us-west-2.fragment.dev/products

{
  "data": [
    {
      "id": "product_1234567890",
      "code": "PROD_001",
      "created": "2024-01-13T00:00:00Z",
      "description": "Premium subscription service",
      "paid_by_roles": [
        {
          "id": "role_def123",
          "name": "buyer"
        }
      ],
      "paid_to_roles": [
        {
          "id": "role_def123",
          "name": "buyer"
        }
      ],
      "updateVersion": 1,
      "workspaceId": "ws_1234567890"
    }
  ]
}

Returns Examples

{
  "data": [
    {
      "id": "product_1234567890",
      "code": "PROD_001",
      "created": "2024-01-13T00:00:00Z",
      "description": "Premium subscription service",
      "paid_by_roles": [
        {
          "id": "role_def123",
          "name": "buyer"
        }
      ],
      "paid_to_roles": [
        {
          "id": "role_def123",
          "name": "buyer"
        }
      ],
      "updateVersion": 1,
      "workspaceId": "ws_1234567890"
    }
  ]
}