Product overview

Documentation

TankTrasa Data API reference

For engineers integrating after signup. Plan pricing and trials are on the product overview.

Overview

HTTPS JSON API with three access levels — Live, Intelligence, and Transparency. All plans can call any endpoint; each request consumes credits from your monthly pool based on the access level used. Included credits reset on billing date.

  • Base URL: shown in your account dashboard
  • OpenAPI spec and Postman collection: API tools section below
  • Country filter: PL, CZ, DE, SK, AT, GB, IT on most endpoints
  • Rate limits: aggregate cap per plan plus per-access-level caps
  • Pagination: list endpoints accept `limit` 1–25 (default 10); Live stations and Intelligence regional stats accept 1–50 (default 25). Out-of-range `limit` returns HTTP 400. Use `page` to walk large result sets (one credit per page).
  • Geo endpoints: Live station search and Intelligence regional stats require a full bounding box (minLat, maxLat, minLng, maxLng) — no national single-call dumps.
  • Explain preview: Transparency explain/price returns a short observation sample; paginate the observations endpoint for full history.

Authentication

Send the secret key in the X-Api-Key header on every request. Create keys in the account dashboard after subscribing. The full key is shown once at creation.

curl -s \
  -H "X-Api-Key: tkm_live_..." \
  "https://api.tanktrasa.com/v1/prices/current?country=PL&fuelType=unleaded&limit=10"

Revoke a key immediately if it leaks. Usage is limited by your credit pool and optional overage settings.

Access levels

Live, Intelligence, and Transparency are the three access levels. Any subscribed account may call any level; deeper levels consume more credits per request.

Standard

Live

Current prices and station search.

100 credits per request

Professional

Intelligence

Fused prices, regional stats, and quality scores.

300 credits per request

Enterprise

Transparency

Source-level observations and explain traces.

2,500 credits per request

API tools

Machine-readable specs for codegen, contract tests, and API clients. The OpenAPI file describes all public Data API paths; the Postman collection includes ready-made requests grouped by access level.

Download OpenAPI (YAML)Import into Swagger UI, Redocly, or your CI schema checks.Open in Swagger EditorInteractive explorer — loads the live spec from the API host.Download Postman collectionv2.1 collection with `baseUrl` and `apiKey` variables.Docs site mirror (YAML)Same spec served from tankomat.app for offline-friendly downloads.

Postman setup

  1. Import the JSON collection (File → Import).
  2. Open collection variables and set `apiKey` to your dashboard secret.
  3. Set `baseUrl` to your API host (production or local backend).
  4. Send a Live request to verify authentication.

JavaScript (fetch)

const response = await fetch(
  "https://api.tanktrasa.com/v1/prices/current?country=PL&fuelType=unleaded&limit=10",
  { headers: { "X-Api-Key": process.env.TANKOMAT_API_KEY! } },
);
const data = await response.json();

Interactive reference

Browse endpoints, inspect response schemas, and try requests (Authorize → X-Api-Key). Try it out calls are proxied via this site to avoid browser CORS limits.

Endpoints

Paths are relative to the API host. Query parameters vary — the examples use common filters only.

AccessMethodPathSummary
LiveStandardGET/v1/prices/currentLatest price per station
LiveStandardGET/v1/stationsStations in a bounding box
IntelligenceProfessionalGET/v2/prices/fusedFused price + confidence
IntelligenceProfessionalGET/v2/prices/compareSide-by-side price views
IntelligenceProfessionalGET/v2/market/regionRegional price stats
IntelligenceProfessionalGET/v2/meta/station-qualityStation quality score
TransparencyEnterpriseGET/v3/observationsObservations by source
TransparencyEnterpriseGET/v3/prices/fusedFused price with sources
TransparencyEnterpriseGET/v3/trust/sourcesSource trust profile
TransparencyEnterpriseGET/v3/explain/priceWhy this price won

Credits

Each HTTP request consumes credits based on the access level you call. Included credits reset monthly. When the pool is empty, requests fail unless overage is enabled.

Example: 1,000 Intelligence calls use 300,000 credits (300 credits per call). One Transparency call uses 2,500 credits.

  • Live100 credits / call
  • Intelligence300 credits / call
  • Transparency2500 credits / call

Overage

Enable overage in the dashboard to keep calling after included credits are used. Overage appears on your monthly invoice. You can set a EUR spend cap and optional email alerts.

Attribution

When showing prices to end users, credit TankTrasa and comply with upstream source licences. Contact sales before redistributing raw API responses or offering white-label data.

Support

Billing and contracts: sales@tankomat.app. Integration help: include the endpoint, approximate time, and any error body from the response.

Account dashboard