Retrieve

GET/products/{code}

Gets a product by code

Path ParametersExpand Collapse

code: string

Product code

ReturnsExpand Collapse

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

Product object

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

Retrieve

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

{
  "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"
  }
}