Get a product | Solvimon

curl https://test.api.solvimon.com/v1/products/ \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json"

{
  "category_id": "cat12345",
  "name": "Wireless Bluetooth Headphones",
  "reference": "WBH-2024",
  "product_type": "DEFAULT",
  "object_type": "product",
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "category": {
    "name": "Electronics",
    "reference": "ELEC-001",
    "object_type": "category",
    "id": "cat12345",
    "description": "Category for all electronic devices and accessories",
    "tax_category": "STANDARD",
    "display_order": 10
  },
  "parent_product_id": "00000000-0000-0000-0000-000000000000",
  "description": "High-quality wireless headphones with noise cancellation",
  "status": "DRAFT",
  "tax_category": "STANDARD",
  "features": [
    {
      "reference": "NOISE-CANCEL",
      "id": "feat98765"
    }
  ],
  "custom_fields": [
    {
      "id": "cf123456",
      "reference": "color",
      "value": "Matte Black",
      "values": [
        "Matte Black",
        "Glossy White"
      ],
      "integration_details": {
        "payment_gateway_variant": "STRIPE",
        "id": "intg7890",
        "reference": "stripe_integration",
        "adyen": {
          "recurring_detail_reference": ""
        },
        "stripe": {
          "payment_method_id": "pm_1GqIC8Lz0qyl6XeWzXxYz123"
        }
      }
    }
  ],
  "display_order": 5,
  "linked_integrations": [
    {
      "id": "link4567",
      "link_details": [
        {
          "url": "https://example.com/product/wireless-bluetooth-headphones",
          "custom_field_name": "product_page_url"
        }
      ]
    }
  ],
  "billing_entity_id": "be123456789"
}

Requires the PRODUCT.VIEW permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

resourceIdOrReferencestringRequiredDefaults to

The ID or reference of the resource.

Query parameters

expand[]list of stringsOptional

The id fields of the resources that are going to be expanded.

Response

category_idstring

The resource ID of the product category, that belongs to the product.

namestringformat: "^.*$"0-256 characters

referencestringformat: "^\S+$"0-256 characters

product_typeenum

Allowed values:

object_typestring or nullRead-only

idstring or nullRead-only

categoryobject or null

parent_product_idstring or null

The resource ID of the original product, to which the product will belong to.

descriptionstring or nullformat: "^.*$"0-256 characters

statusenum or null

The status of the product.

Allowed values:

tax_categoryenum or null

The default tax category applied to the product.

Allowed values:

featureslist of objects or null

The features associated with the product.

custom_fieldslist of objects or null

display_orderinteger or null

Determines the order in which products are displayed on overview pages and invoices. The lowest number gets the highest priority.

linked_integrationslist of objects or null

billing_entity_idstring or null

The resource ID of the billing entity linked to this product.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors