---
title: "Sellable products with sell price, evidence level and live availability"
method: GET
path: "/v1/catalog"
tags: ["catalog"]
---

# Sellable products with sell price, evidence level and live availability

`GET /v1/catalog`

## Request

- Base URL: `https://api.portproof.org`
- URL: `https://api.portproof.org/v1/catalog`
- Auth: none required

Never exposes upstream cost, markup or source credentials. `evidence` is `signed` for ports on farms running the Portproof agent and `observed` for resold upstream ports. Dedicated ports from the partner network appear only while they are on sale; organisations with early access see them when they call with their session or API key.

## Query parameters

- `kind` 'port' | 'bandwidth' | 'topup' | 'sms' | 'esim'
- `country` string

## Response `200`

Default Response

- object
  - `products` object[], required
    - `id` string, required
    - `sku` string, required
    - `kind` 'port' | 'bandwidth' | 'topup' | 'sms' | 'esim', required
    - `title` string, required
    - `country` string, nullable, required
    - `carrier_hint` string, nullable, required
    - `term` 'monthly' | 'weekly' | 'daily' | 'gb' | 'none', required
    - `sell_cents` integer, required
    - `currency` 'EUR' | 'USD', required
    - `evidence` 'signed' | 'observed', required
    - `operator_label` string, required
    - `stock` integer, nullable, required
    - `available` boolean, required
    - `supply_health` 'ok' | 'degraded' | 'down' | 'unknown', required
    - `tiers` object[], nullable
      - `min_qty` integer, required
      - `unit_cents` integer, required
    - `gb_per_unit` number, nullable
    - `once_per_customer` boolean

---

[API](https://skmtc.dev/portproof/apis/portproof-api.md) · [All operations](https://skmtc.dev/portproof/apis/portproof-api/llms.txt) · [OpenAPI document](https://skmtc.dev/portproof/apis/portproof-api/revisions/4143916c0fac?raw)