Dla deweloperów i asystentów AI

Publiczne API i serwer MCP

Udostępniamy aktualny cennik świadectw charakterystyki energetycznej, FAQ i listę obsługiwanych miast jako darmowe API JSON — bez klucza, bez rejestracji, z otwartym CORS. Osobno działa serwer MCP, przez który asystent AI może złożyć zamówienie w imieniu klienta.

Autoryzacja: Brak — endpointy otwarte
Format: JSON, UTF-8, język polski
Cache: 1 h w przeglądarce, 24 h na CDN

Zasady korzystania

Bez klucza i bez limitu. Endpointy tylko-do-odczytu odpowiadają na zwykłe GET i obsługują OPTIONS (preflight). Odpowiedź jest cache'owana, więc nie ma sensu odpytywać ich częściej niż raz na godzinę.
Podaj źródło. Możesz wykorzystać te dane u siebie, jeśli wskażesz źródło linkiem do swiadectwo-energetyczne24.pl. Nie podawaj naszej oferty jako własnej.
Ceny się zmieniają. basePricePln to zawsze aktualna cena brutto z VAT. Jeśli pokazujesz ceny u siebie, pobieraj je z API zamiast przepisywać — inaczej Twoja strona pokaże nieaktualną kwotę.
Bez wersjonowania, bez SLA. Nowe pola dopisujemy tak, żeby nie psuć istniejących integracji; o usunięciu pola uprzedzimy na tej stronie. Nie gwarantujemy dostępności — przy krytycznej integracji napisz na kontakt@swiadectwo-energetyczne24.pl.

Cennik świadectw

GEThttps://swiadectwo-energetyczne24.pl/api/pricingOtwórz ↗

Aktualne ceny brutto dla każdego typu nieruchomości, opcje dodatkowe, czas realizacji i lista tego, co jest w cenie. To ten sam cennik, który widzi klient w kalkulatorze ceny.

Pole	Typ	Opis
currency	string	Waluta cen — zawsze PLN.
pricesIncludeVat	boolean	Zawsze true: wszystkie kwoty są brutto, z VAT.
propertyTypes[]	array	slug, label, basePricePln, description, orderUrl — jeden wpis na typ nieruchomości.
addons[]	array	key, label, pricePln, description — dopłaty doliczane do ceny bazowej.
leadTime	object	Czas realizacji standardowej i ekspresowej.
included[]	string[]	Co zawiera cena (m.in. wpis do rejestru CHEB).
contact	object	E-mail i telefon do obsługi klienta.
links	object	Adresy powiązanych narzędzi i pozostałych endpointów.

curl

curl -s https://swiadectwo-energetyczne24.pl/api/pricing | jq '.propertyTypes[] | {slug, basePricePln}'

Odpowiedź 200 OK

{
  "service": "Świadectwo charakterystyki energetycznej — 100% online",
  "provider": "Świadectwo Energetyczne 24",
  "currency": "PLN",
  "pricesIncludeVat": true,
  "serviceArea": "Polska (obsługa w pełni zdalna)",
  "propertyTypes": [
    {
      "slug": "mieszkanie",
      "label": "Mieszkanie",
      "basePricePln": 148.62,
      "description": "Świadectwo dla mieszkania w bloku, kamienicy lub apartamentowcu.",
      "orderUrl": "https://swiadectwo-energetyczne24.pl/zamow/mieszkanie"
    }
  ],
  "addons": [
    {
      "key": "express24h",
      "label": "Express 24H",
      "pricePln": 99,
      "description": "Realizacja w ciągu 24 godzin roboczych."
    },
    {
      "key": "paperVersion",
      "label": "Papierowa wersja",
      "pricePln": 59,
      "description": "Wysyłka świadectwa w wersji papierowej z podpisem. Kurierem InPost w 6 dni."
    }
  ],
  "leadTime": {
    "standard": "1–3 dni robocze",
    "express24h": "24 godziny robocze (dodatek Express 24H)"
  },
  "included": [
    "Sporządzenie przez audytora z uprawnieniami",
    "Podpis elektroniczny"
  ],
  "contact": {
    "email": "kontakt@swiadectwo-energetyczne24.pl",
    "phone": "+48796437057"
  },
  "links": {
    "documentation": "https://swiadectwo-energetyczne24.pl/api",
    "priceCalculator": "https://swiadectwo-energetyczne24.pl/kalkulator-ceny",
    "needCheck": "https://swiadectwo-energetyczne24.pl/czy-potrzebuje-swiadectwa",
    "faqApi": "https://swiadectwo-energetyczne24.pl/api/faq",
    "citiesApi": "https://swiadectwo-energetyczne24.pl/api/cities",
    "mcpServer": "https://swiadectwo-energetyczne24.pl/api/mcp"
  }
}

Przykład skrócony (propertyTypes: 1 z 3, included: 2 z 4) — pełną odpowiedź zobaczysz pod adresem endpointu.

Pytania i odpowiedzi

GEThttps://swiadectwo-energetyczne24.pl/api/faqOtwórz ↗

Wszystkie pytania i odpowiedzi z serwisu w jednym miejscu: FAQ ze strony głównej plus FAQ dołączone do artykułów poradnika. Każdy wpis ma sourceUrl — adres strony, z której pochodzi odpowiedź, więc asystent AI może podać źródło.

Pole	Typ	Opis
language	string	Język treści — pl-PL.
count	number	Liczba pozycji w tablicy faq.
faq[].question	string	Pytanie w brzmieniu ze strony.
faq[].answer	string	Pełna odpowiedź, zwykły tekst bez HTML.
faq[].sourceUrl	string	Adres strony, na której odpowiedź jest opublikowana.

curl

curl -s https://swiadectwo-energetyczne24.pl/api/faq | jq '.faq[0]'

Odpowiedź 200 OK

{
  "provider": "Świadectwo Energetyczne 24",
  "language": "pl-PL",
  "count": 58,
  "faq": [
    {
      "question": "Czym jest świadectwo energetyczne?",
      "answer": "To dokument, który określa zapotrzebowanie na energię niezbędną do użytkowania budynku. Pozwala ocenić efektywność energetyczną nieruchomości i jest wymagany prawnie przy sprzedaży lub wynajmie.",
      "sourceUrl": "https://swiadectwo-energetyczne24.pl/#faq"
    }
  ],
  "links": {
    "documentation": "https://swiadectwo-energetyczne24.pl/api",
    "guide": "https://swiadectwo-energetyczne24.pl/poradnik",
    "pricingApi": "https://swiadectwo-energetyczne24.pl/api/pricing"
  }
}

Przykład skrócony (faq: 1 z 58) — pełną odpowiedź zobaczysz pod adresem endpointu.

Obsługiwane miasta

GEThttps://swiadectwo-energetyczne24.pl/api/citiesOtwórz ↗

Lista miast z dedykowaną stroną usługi wraz z województwem. Obsługujemy całą Polskę w jednakowych cenach — te strony są punktem wejścia dla klientów szukających lokalnie, a nie osobnym cennikiem.

Pole	Typ	Opis
count	number	Liczba miast na liście.
cities[].name	string	Nazwa miasta.
cities[].slug	string	Identyfikator w adresie strony miasta.
cities[].voivodeship	string	Województwo (pełna nazwa po polsku).
cities[].url	string	Adres strony usługi w tym mieście.

curl

curl -s https://swiadectwo-energetyczne24.pl/api/cities | jq '.cities[] | select(.voivodeship == "mazowieckie")'

Odpowiedź 200 OK

{
  "provider": "Świadectwo Energetyczne 24",
  "serviceArea": "Polska (obsługa w pełni zdalna, jednolite ceny)",
  "count": 60,
  "cities": [
    {
      "name": "Warszawa",
      "slug": "warszawa",
      "voivodeship": "mazowieckie",
      "url": "https://swiadectwo-energetyczne24.pl/swiadectwo-energetyczne/warszawa"
    },
    {
      "name": "Kraków",
      "slug": "krakow",
      "voivodeship": "małopolskie",
      "url": "https://swiadectwo-energetyczne24.pl/swiadectwo-energetyczne/krakow"
    }
  ],
  "links": {
    "documentation": "https://swiadectwo-energetyczne24.pl/api",
    "allCities": "https://swiadectwo-energetyczne24.pl/swiadectwo-energetyczne",
    "pricingApi": "https://swiadectwo-energetyczne24.pl/api/pricing"
  }
}

Przykład skrócony (cities: 2 z 60) — pełną odpowiedź zobaczysz pod adresem endpointu.

Serwer MCP — zamówienie przez asystenta AI

POSThttps://swiadectwo-energetyczne24.pl/api/mcp

Serwer Model Context Protocol (transport Streamable HTTP, bezstanowy). Pozwala agentowi AI zebrać dane nieruchomości, sprawdzić czego brakuje, wycenić zamówienie, dołączyć dokumenty i wygenerować link do płatności. Endpoint jest publiczny, limit 60 żądań na 10 minut z jednego adresu IP.

Granica jest twarda: agent nigdy nie przyjmuje danych karty ani zgód prawnych i nie liczy ceny sam. Zgody RODO, akceptację regulaminu i płatność wykonuje człowiek pod wygenerowanym linkiem. Każde zamówienie chroni własny access_token zwracany tylko raz — samo order_id nie otwiera niczego.

Podłączenie klienta MCP

W Claude Desktop, Claude Code lub innym kliencie MCP wystarczy adres serwera — bez tokenu:

Konfiguracja klienta MCP

{
  "mcpServers": {
    "swiadectwo-energetyczne24": {
      "type": "http",
      "url": "https://swiadectwo-energetyczne24.pl/api/mcp"
    }
  }
}

Narzędzia serwera

Narzędzie	Co robi
get_property_types	Typy nieruchomości, dla których wystawiamy świadectwo, z cenami bazowymi.
get_certificate_options	Opcje dodatkowe (Express 24H, wersja papierowa) i ich ceny.
get_certificate_information	Informacje o usłudze: czas realizacji, co jest w cenie, podstawa prawna.
create_certificate_order	Zakłada zamówienie i zwraca access_token — jedyny raz, więc agent musi go zapamiętać.
get_certificate_order_requirements	Mówi, czego jeszcze brakuje, żeby zamówienie dało się opłacić.
update_certificate_order	Uzupełnia dane zamówienia (adres, dane techniczne, kontakt).
get_certificate_order	Zwraca zebrane dane zamówienia (wymaga order_id + access_token).
get_certificate_order_status	Status zamówienia — także po opłaceniu, gdy dane są już zamrożone.
calculate_certificate_price	Liczy cenę po stronie serwera; agent nigdy nie wylicza jej sam.
get_payment_link	Bezpieczny link, pod którym klient akceptuje zgody i płaci.
create_document_upload_url	Adres presigned PUT do wgrania dokumentu prosto do naszego magazynu.
add_property_document	Podpina wgrany plik (rzut, zdjęcie elewacji) pod zamówienie.

Serwer wystawia też krótsze aliasy dla prostych integracji: list_property_types, get_form_fields, get_pricing, create_draft, update_draft, get_draft.

Pełny przebieg rozmowy z agentem opisaliśmy w poradniku: jak zamówić świadectwo energetyczne przez AI.

Czego API nie udostępnia

Wyszukiwarki rejestru CHEB. Endpointy pod /api/swiadectwa/ obsługują wyłącznie naszą wyszukiwarkę świadectw — przyjmują żądania tylko z tej domeny i mają limit zapytań. Surowe dane rejestru są jednak publiczne: Ministerstwo Rozwoju i Technologii udostępnia je na dane.gov.pl na licencji CC0.
Danych zamówień i klientów. Zamówienie widać wyłącznie z jego access_token (MCP) albo z linku do statusu, który klient dostaje mailem. Nie ma endpointu listującego zamówienia.
Wyliczeń świadectwa. Silnik obliczeniowy nie jest wystawiony na zewnątrz. Orientacyjne wskaźniki policzysz w bezpłatnym kalkulatorze EP, EK i EU.

Najczęstsze pytania o API

Czy API jest darmowe i czy potrzebuję klucza?

Tak, jest darmowe i nie wymaga klucza ani rejestracji. Endpointy /api/pricing, /api/faq i /api/cities odpowiadają na zwykłe żądanie GET, mają otwarty CORS (Access-Control-Allow-Origin: *), więc można je wołać także prosto z przeglądarki.

Czy mogę użyć tych danych na swojej stronie?

Tak. Możesz pokazywać nasz cennik, FAQ i listę miast we własnym serwisie, aplikacji lub asystencie AI, pod warunkiem podania źródła z linkiem do swiadectwo-energetyczne24.pl. Nie zezwalamy na podawanie tych danych jako własnej oferty ani na sugerowanie, że świadectwo wystawia ktoś inny niż nasi audytorzy.

Jakie są limity zapytań?

Nie ma twardego limitu na endpointach tylko-do-odczytu — odpowiedzi są cache'owane na CDN (24 godziny), więc odpytywanie częściej niż raz na godzinę i tak nie zwróci nowszych danych. Serwer MCP ma limit 60 żądań na 10 minut z jednego adresu IP.

Czy przez API mogę złożyć zamówienie?

Nie przez endpointy REST — one są tylko do odczytu. Zamówienie tworzy się przez serwer MCP (/api/mcp): agent zbiera dane, wycenia i generuje bezpieczny link do płatności, a klient sam potwierdza zgody i płaci na naszej stronie. Danych karty ani zgód RODO agent nigdy nie zbiera.

Czy udostępniacie API do wyszukiwarki świadectw z rejestru CHEB?

Nie. Wyszukiwarka rejestru działa wyłącznie na naszej stronie — jej endpointy są ograniczone do żądań z tej domeny i objęte limitem zapytań. Surowe dane rejestru są jednak dostępne publicznie na dane.gov.pl, bo to dane otwarte Ministerstwa Rozwoju i Technologii na licencji CC0.

Czy API ma wersjonowanie i SLA?

Nie ma wersjonowania w adresie — pola dopisujemy w sposób nierozwalający istniejących integracji, a o usunięciu któregokolwiek pola uprzedzimy na tej stronie. Serwis nie daje gwarancji dostępności (SLA); przy krytycznej integracji napisz do nas, a ustalimy warunki.

Budujesz coś na naszym API?

Napisz, czego potrzebujesz — brakującego pola, wyższego limitu albo współpracy partnerskiej (biura nieruchomości, notariusze, portale ogłoszeniowe). Odpowiadamy zwykle tego samego dnia.

kontakt@swiadectwo-energetyczne24.pl Formularz kontaktowy