{"id":"0f8510c6-0dff-4dbe-8b59-c0914828d69a","type":"API","name":"Revenue, total","slug":"revenue-total","description":"PUBLIC FINANCE › REVENUE OF GMINAS AND CITIES WITH POWIAT STATUS BUDGETS. Local Data Bank (BDL) subject P2621: yearly territorial series for Poland (voivodship to gmina level), units keyed by TERYT ids.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://api.stat.gov.pl/Home/BdlApi","docs_url":"https://api.stat.gov.pl/Home/BdlApi","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":[],"logo_url":"https://api.stat.gov.pl/Content/images/favicon.ico","primary_source_url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2621","extraction_confidence":"0.40","created_at":"2026-07-25T11:33:35.454Z","updated_at":"2026-09-06T23:02:04.170Z","last_verified_at":"2026-09-06T11:11:34.024Z","deprecated_at":null,"ranking_score":55,"last_ranked_at":"2026-08-30T19:59:45.430Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-09-06T23:02:04.170Z","search_vector":"'and':41B 'bank':16B,49B 'bdl':17B,50B 'budget':13B 'budgets':46B 'by':64B 'citi':9B 'cities':42B 'data':15B,48B 'financ':4B 'finance':37B 'for':56B 'gmina':7B,27B,60B 'gminas':40B 'id':33B 'ids':66B 'key':30B 'keyed':63B 'level':28B,61B 'local':14B,47B 'of':39B 'p2621':19B,52B 'poland':24B,57B 'powiat':11B,44B 'public':3B,36B 'revenu':1A,5B 'revenue':34A,38B 'seri':22B 'series':55B 'status':12B,45B 'subject':18B,51B 'territori':21B 'territorial':54B 'teryt':32B,65B 'to':59B 'total':2A,35A 'unit':29B 'units':62B 'voivodship':25B,58B 'with':43B 'year':20B 'yearly':53B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"2b3815fc-d28d-444c-b8f1-906ef8cff848","institution_type":"STATISTICS_OFFICE","country_code":"PL","official_confidence":40,"proof_summary":"40% - Official domain (stat.gov.pl)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-25T13:09:03.264Z","geographic_scope":"NATIONAL","name_en":null,"description_en":null,"native_lang":null,"access_level":"direct","formats":[],"capability_tier":"live","trust_score":58.25,"merged_into_entry_id":null,"identity_key":"API|https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2621|revenue, total","upstream_ref":"bdl.stat.gov.pl:subject:P2621","access":{"level":"direct","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P2621","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P2621","source":"probe","runnable":true},{"kind":"query","label":"Values of one variable across territorial units","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/76037?unit-level=6&page-size=10&format=json&lang=en","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"Documentation","method":"GET","url":"https://api.stat.gov.pl/Home/BdlApi","source":"query_example","runnable":true,"direct":false},{"kind":"landing","label":"Open source record","method":"GET","url":"https://bdl.stat.gov.pl/bdl/dane/podgrup/temat#P2621","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"0f8510c6-0dff-4dbe-8b59-c0914828d69a","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"joinable","level_index":5,"level_label":"Joinable","meaning":"Canonical identifiers and concepts mapped","counts_as_coverage":true,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":true,"reached":true,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":true,"reached":true,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"2b3815fc-d28d-444c-b8f1-906ef8cff848","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"bdl.stat.gov.pl","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-09-08T18:00:07.223Z"},"api_details":{"id":"ec3e10ec-9e39-4b8a-a0c8-eda5e15dcd7a","entry_id":"0f8510c6-0dff-4dbe-8b59-c0914828d69a","base_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2621","openapi_url":null,"graphql_url":null,"api_version":null,"spec_format":null,"endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2621","created_at":"2026-07-25T11:33:35.612Z","updated_at":"2026-07-25T11:33:35.612Z"},"dataset_details":null,"license":{"id":"cc-by-4.0","spdx_id":"CC-BY-4.0","name":"Creative Commons Attribution 4.0","url":"https://creativecommons.org/licenses/by/4.0/","is_open":true,"is_redistributable":true,"requires_attribution":true,"category":"cc","notes":null,"created_at":"2026-06-12T16:29:19.729Z"},"reuse":{"license_id":"cc-by-4.0","license_name":"Creative Commons Attribution 4.0","license_url":"https://creativecommons.org/licenses/by/4.0/","commercial_use":{"status":"yes","value":true},"redistribution":{"status":"yes","value":true},"attribution_required":{"status":"yes","value":true},"share_alike":{"status":"no","value":false},"personal_data_warning":{"status":"yes","value":true},"cache_and_mirror":{"status":"yes","value":true},"undetermined":[],"basis":"licence_text","confidence":0.95,"confidence_tier":"high","source_text":"Deed: \"Share - copy and redistribute the material in any medium or format for any purpose, even commercially\" and \"Adapt - remix, transform, and build upon the material for any purpose, even commercially\". Under the following terms: \"Attribution - You must give appropriate credit, provide a link to the license, and indicate if changes were made.\" Notices: \"other rights such as publicity, privacy, or moral rights may limit how you use the material.\" Attribution is the only term listed; no ShareAlike term appears.","source_url":"https://creativecommons.org/licenses/by/4.0/","reviewed_at":null},"license_raw":"CC BY 4.0 (GUS BDL)","latest_check":{"id":"12760f6c-1e05-42a8-8ca8-a1abe4cc5aa5","entry_id":"0f8510c6-0dff-4dbe-8b59-c0914828d69a","status":"VERIFIED","last_checked_at":"2026-09-06T11:11:33.773Z","p50_latency_ms":920,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-27T20:28:47.272Z","updated_at":"2026-09-06T11:11:33.773Z","consecutive_successes":9,"probe_url":"https://bdl.stat.gov.pl/api/v1/subjects/P2621","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json; charset=utf-8","probe_succeeded_at":"2026-09-06T11:11:33.773Z"},"data_profile":{"id":"80c0b4ff-086a-4f0a-a7f3-4af6fa2cc923","entry_id":"0f8510c6-0dff-4dbe-8b59-c0914828d69a","profile_source":"bdl","profile_kind":"dataset","dataset_id":"P2621","fields":[{"name":"variable_id","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"description":"GUS variable id selecting the measured series of subject P2621 (the n1/n2 dimension combination): 76037=gminas include cities with powiat status / total [PLN]; 76035=gminas without cities with powiat status / total [PLN]; 76036=cities with powiat status / total [PLN].","enum_values":["76037","76035","76036"]},{"name":"unit_level","role":"parameter","type":"integer","label":null,"param_in":"query","description":"Territorial aggregation level: 0=Poland, 1=macroregion, 2=voivodship (województwo), 3=region, 4=subregion, 5=powiat, 6=gmina.","enum_values":["0","1","2","3","4","5","6"]},{"name":"year","role":"parameter","type":"integer","label":null,"param_in":"query","description":"Reference year of the value (yearly series, back to 1995 for the oldest subjects). Filters server-side via the API's year parameter."},{"name":"unit_id","type":"string","label":null,"description":"12-digit BDL territorial-unit id (macroregion+voivodship+region+subregion+powiat+gmina+type digits). An equality filter pins the unit server-side (unit-parent-id)."},{"name":"unit_name","type":"string","label":null,"description":null},{"name":"teryt_terc","type":"string","label":null,"description":"TERYT TERC territorial code derived from the unit id (2 digits = voivodship, 4 = powiat, 7 = gmina incl. type digit; empty for NUTS-only units)."},{"name":"value","type":"number","label":null,"description":null},{"name":"attr_id","type":"integer","label":null,"description":"GUS value-attribute id (data quality/annotation flag)."}],"field_count":8,"sample_records":[{"year":1995,"value":14906933,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":1996,"value":18479910,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":1997,"value":21390693,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":1998,"value":27343743,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":1999,"value":30310387,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":2000,"value":34566316,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":2001,"value":39944299,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"},{"year":2002,"value":38962033,"attr_id":1,"unit_id":"011212001011","unit_name":"Bochnia","teryt_terc":"1201011","unit_level":"6","variable_id":"76037"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/76037?unit-level=6&page-size=10&format=json&lang=en","curl":"curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/76037?unit-level=6&page-size=10&format=json&lang=en'","label":"Values of one variable across territorial units","method":"GET","description":"Yearly values of variable 76037 (gminas include cities with powiat status / total [PLN]) per territorial unit. Filters: unit-level=0–6, year=YYYY, unit-parent-id={12-digit unit id}; page-size ≤ 100. Anonymous limits: 5 req/s, 100 req/15 min."},{"url":"https://api.stat.gov.pl/Home/BdlApi","curl":"curl -s 'https://api.stat.gov.pl/Home/BdlApi'","label":"Documentation","method":"GET","description":"GUS BDL API reference (endpoints, parameters, limits, CC BY 4.0 licence)."}],"status":"ok","error_message":null,"profiled_at":"2026-09-01T18:35:34.315Z","run_id":"2ccf34bf-3ed3-4e72-a902-9d52eaa4b18d","created_at":"2026-07-25T11:52:33.479Z","updated_at":"2026-09-01T18:35:34.315Z","license_raw":"CC BY 4.0 (GUS BDL)","license_id":"cc-by-4.0","consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":true,"personal_data":{"status":"none","basis":"no_person_column_cited","grain":"none","allowed":true,"columns":{"direct_identifiers":[],"family_names":[],"given_names":[],"attributes":[],"unresolved_names":[],"measures":[],"entity_identifiers":[]},"publication":null,"publication_evidence":null,"notice":"personal data: no cited column names a natural person (the cited columns are all this reads)"}},"datasets":[],"limits":[],"manifest":{"answer_sha256":"809692ebc256ec1d9c014f0528e607711b616a2c01c72dac88b430d34c7e8c37","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":29,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (8 rows).","live":false,"live_basis":"This body was replayed from the worker edge cache (x-edge-cache: hit); the bytes, and therefore answer_sha256, are those of the execution that filled the cache.","created_at":"2026-09-08T18:00:28.680Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}