GET /api/v1/developer/catalog

Returns all products tracked by the Coda oracle, with their PriceCharting IDs and the earliest date price data is available for each.

---

Request

GET /api/v1/developer/catalog
X-API-Key: your_api_key

No path or query parameters.

Example

curl "https://api.coda-tech.net/api/v1/developer/catalog" \
  -H "X-API-Key: your_api_key"

---

Response 200

{
  "total": 60,
  "products": [
    {
      "product_key": "pokemon-sws07-umbreon-vmax-alt-art-secret",
      "pricecharting_id": "2513024",
      "product_name": "Umbreon VMAX Alt Art",
      "product_type": "single_card",
      "era": "modern",
      "earliest_observation": "2025-01-01"
    },
    {
      "product_key": "pokemon-destined-rivals-booster-box",
      "pricecharting_id": "9420220",
      "product_name": "Destined Rivals Booster Box",
      "product_type": "booster_box",
      "era": "modern",
      "earliest_observation": "2025-03-25"
    }
  ]
}

Fields

Field	Type	Description
total	int	Total number of tracked products
products	array	List of catalog entries
product_key	string	Coda's internal catalog key
pricecharting_id	string	PriceCharting numeric product ID
product_name	string	Human-readable card name
product_type	string	single_card or booster_box
era	string	modern or vintage — controls grading ratio tables
earliest_observation	string	Earliest UTC date (YYYY-MM-DD) with price data in the database. null if no observations exist yet.

---

Usage

Use this endpoint to discover all supported pricecharting_id values before calling:

• PriceCharting Lookup — current pricing bundle
• Price Snapshot — point-in-time oracle for a specific date

---

Errors

HTTP	When
401	Missing or invalid API key
503	Database unreachable