Retrieve a product

curl --request GET \
  --url https://api.taberna.io/v1/products/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.taberna.io/v1/products/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.taberna.io/v1/products/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.taberna.io/v1/products/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.taberna.io/v1/products/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83",
  "title": "Nitro — 1 Month",
  "body": "<string>",
  "price": "49.99",
  "currency": "usd",
  "productType": "single-purchase",
  "listed": true,
  "image": "https://cdn.taberna.io/products/nitro.png",
  "deliveryType": "text_pool",
  "stock": 42,
  "minQuantity": 1,
  "maxQuantity": 10,
  "createdAt": "2026-07-29T14:30:00.000Z",
  "updatedAt": "2026-07-29T14:30:00.000Z"
}

{
  "error": "Order not found"
}

{
  "error": "Order not found"
}

{
  "error": "Order not found"
}

{
  "error": "Order not found"
}

GET

products

{id}

Retrieve a product

curl --request GET \
  --url https://api.taberna.io/v1/products/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.taberna.io/v1/products/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.taberna.io/v1/products/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.taberna.io/v1/products/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.taberna.io/v1/products/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83",
  "title": "Nitro — 1 Month",
  "body": "<string>",
  "price": "49.99",
  "currency": "usd",
  "productType": "single-purchase",
  "listed": true,
  "image": "https://cdn.taberna.io/products/nitro.png",
  "deliveryType": "text_pool",
  "stock": 42,
  "minQuantity": 1,
  "maxQuantity": 10,
  "createdAt": "2026-07-29T14:30:00.000Z",
  "updatedAt": "2026-07-29T14:30:00.000Z"
}

{
  "error": "Order not found"
}

{
  "error": "Order not found"
}

{
  "error": "Order not found"
}

{
  "error": "Order not found"
}

Authorizations

Authorization

string

header

required

A store API key, sent as Authorization: Bearer <key>.

A key looks like tbrn_live_ followed by 48 hex characters, e.g. tbrn_live_4f2a...c91b. Mint one in the Taberna dashboard under Developers → API Keys, tick the scopes the integration needs, and copy it there and then — the full value is shown once and only its hash is stored, so a lost key is replaced rather than recovered.

One key belongs to one store and carries a fixed scope set. Send it from a server, never from a browser: it can create orders and invoices and read every order the store has.

Path Parameters

string<uuid>

required

The product to act on. Formatted as a UUID, e.g. 3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83.

Example:

"3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83"

Response

The product.

A product in the store's catalogue.

string<uuid>

required

The product's id — pass it in an order's items to sell it. Formatted as a UUID, e.g. 3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83.

Example:

"3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83"

title

string

required

Product name as shown at checkout.

Example:

"Nitro — 1 Month"

body

string | null

required

Long-form product description. Null when unset.

price

string

required

Price of one unit. Decimal string in the resource's fiat currency, e.g. "49.99" — a string, never a JSON number, so no precision is lost in transit.

Example:

"49.99"

currency

enum<string>

required

The fiat currency every amount on this resource is priced in. Crypto is quoted against it at payment time.

Available options:

usd,

eur

Example:

"usd"

productType

enum<string>

required

How the product is sold. single-purchase — a one-off purchase, the only mode today.

Available options:

single-purchase

Example:

"single-purchase"

listed

boolean

required

Whether the product is visible on the storefront. Unlisted products can still be bought through an order you create.

Example:

true

image

string | null

required

Absolute URL of the product image, or null when it has none.

Example:

"https://cdn.taberna.io/products/nitro.png"

deliveryType

enum<string> | null

required

How the product is fulfilled once an order completes. text_pool — one line of stock per unit sold (keys, codes, accounts). text_shared — the same text to every buyer. file_shared — the same file, handed over as a short-lived download link. redirect — the buyer is sent to a URL you host. Null when no delivery is configured yet. The contents are never exposed here — only the type and, for pools, the remaining count.

Available options:

text_pool,

text_shared,

file_shared,

redirect

stock

integer | null

required

Units still available for a text_pool delivery. Null when delivery is unlimited (text_shared, file_shared, redirect) or not configured.

Required range: -9007199254740991 <= x <= 9007199254740991

Example:

42

minQuantity

integer

required

Fewest units one order may buy.

Required range: -9007199254740991 <= x <= 9007199254740991

Example:

1

maxQuantity

integer | null

required

Most units one order may buy. Null when uncapped.

Required range: -9007199254740991 <= x <= 9007199254740991

Example:

10

createdAt

string<date-time>

required

When the product was created. UTC timestamp in ISO 8601, e.g. 2026-07-29T14:30:00.000Z.

Example:

"2026-07-29T14:30:00.000Z"

updatedAt

string<date-time> | null

required

When the product was last edited. Null if never. UTC timestamp in ISO 8601, e.g. 2026-07-29T14:30:00.000Z.

Example:

"2026-07-29T14:30:00.000Z"

Orders

Invoices

Invoice Templates

Products

Store

Webhook Deliveries

Checkout

Retrieve a product

Authorizations

Path Parameters

Response