Skip to main content
GET
/
v1
/
products
/
{product_id}
Error
A valid request URL is required to generate request examples
{
  "id": "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
  "reference": "one-day-pass",
  "name": "One Day Pass",
  "description": "Full day access to the coworking space including all amenities, meeting rooms, and common areas. Valid from 9:00 AM to 6:00 PM.",
  "price": 2500,
  "type": "one_time",
  "category": "booking",
  "metadata": {
    "durationType": "daily",
    "durationValue": 1
  },
  "currency": "EUR",
  "spaces": [
    "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
    "b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 authentication for Boseat API

Path Parameters

​
product_id
string
required

Unique identifier of the product

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

Response

Product found and returned with complete details

​
id
string<uuid>
required

Unique identifier (UUID) of the product in the Boseat system

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

​
reference
string
required

Internal reference code for the product. Used for integration with external systems, inventory management, or internal tracking. Must be unique within the organization.

Example:

"one-day-pass"

​
name
string
required

Display name of the product shown to customers in booking interfaces and invoices

Example:

"One Day Pass"

​
description
string
required

Detailed description of the product explaining what it includes, duration, and any special terms or conditions

Example:

"Full day access to the coworking space including all amenities, meeting rooms, and common areas. Valid from 9:00 AM to 6:00 PM."

​
price
number
required

Price of the product in the smallest currency unit (cents). For example, 100 represents 1.00 EUR, 2500 represents 25.00 EUR.

Required range: x >= 0
Example:

2500

​
type
enum<string>
required

Type of product pricing model. ONE_TIME for single purchases, SUBSCRIPTION for recurring billing.

Available options:
one_time,
recurring
Example:

"one_time"

​
category
enum<string>
required

Category of the product determining its usage. BOOKING products are used for space reservations, ADDITIONAL products are supplementary services.

Available options:
booking,
additional
Example:

"booking"

​
metadata
object
required

Product-specific metadata containing configuration and rules. For BOOKING products, must include durationType ("hourly", "daily", "weekly", "monthly") and durationValue (number > 0). For ADDITIONAL products, metadata is optional and can be empty.

Example:
{
  "durationType": "daily",
  "durationValue": 1
}
​
currency
enum<string>
default:EUR

Currency code for the product price. Only EUR is supported.

Available options:
EUR
Example:

"EUR"

​
spaces
string[] | null

List of space IDs where this product is available for booking. Use null to indicate the product is available for all spaces (booking products only). Use an empty array [] to indicate no spaces are assigned yet or for additional products not tied to specific spaces.

Example:
[
  "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
  "b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"
]