{"id":"ff4d9640-fe76-454f-b72f-fbb95e16947c","type":"API","name":"Reintegration units - indicators","slug":"reintegration-units-indicators","description":"SOCIAL ECONOMY › REINTEGRATION UNITS. Local Data Bank (BDL) subject P4499: 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#P4499","extraction_confidence":"0.40","created_at":"2026-07-25T14:44:11.738Z","updated_at":"2026-09-07T15:59:20.908Z","last_verified_at":"2026-09-06T19:57:36.716Z","deprecated_at":null,"ranking_score":58,"last_ranked_at":"2026-08-31T20:48:53.617Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-09-07T15:59:20.908Z","search_vector":"'bank':10B,37B 'bdl':11B,38B 'by':52B 'data':9B,36B 'economi':5B 'economy':32B 'for':44B 'gmina':21B,48B 'id':27B 'ids':54B 'indic':3A 'indicators':30A 'key':24B 'keyed':51B 'level':22B,49B 'local':8B,35B 'p4499':13B,40B 'poland':18B,45B 'reintegr':1A,6B 'reintegration':28A,33B 'seri':16B 'series':43B 'social':4B,31B 'subject':12B,39B 'territori':15B 'territorial':42B 'teryt':26B,53B 'to':47B 'unit':2A,7B,23B 'units':29A,34B,50B 'voivodship':19B,46B 'year':14B 'yearly':41B","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-26T09:29:09.210Z","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#P4499|reintegration units - indicators","upstream_ref":"bdl.stat.gov.pl:subject:P4499","access":{"level":"direct","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P4499","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P4499","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/1735201?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#P4499","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"ff4d9640-fe76-454f-b72f-fbb95e16947c","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":"executable","level_index":4,"level_label":"Executable","meaning":"Queries run through Commodity","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":false,"reached":false,"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-08T21:51:02.902Z"},"api_details":{"id":"6315c619-9151-4245-9dd7-bf999c1c2213","entry_id":"ff4d9640-fe76-454f-b72f-fbb95e16947c","base_url":"https://bdl.stat.gov.pl/api/v1/subjects/P4499","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/P4499","created_at":"2026-07-25T14:44:11.892Z","updated_at":"2026-07-25T14:44:11.892Z"},"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":"ee44b038-8d98-409d-a6aa-79bfb72018ea","entry_id":"ff4d9640-fe76-454f-b72f-fbb95e16947c","status":"VERIFIED","last_checked_at":"2026-09-06T19:57:36.461Z","p50_latency_ms":1881,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-28T05:46:27.530Z","updated_at":"2026-09-06T19:57:36.461Z","consecutive_successes":9,"probe_url":"https://bdl.stat.gov.pl/api/v1/subjects/P4499","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json; charset=utf-8","probe_succeeded_at":"2026-09-06T19:57:36.461Z"},"data_profile":{"id":"5d55f5a5-a36a-4b2f-b60e-6839acea51bc","entry_id":"ff4d9640-fe76-454f-b72f-fbb95e16947c","profile_source":"bdl","profile_kind":"dataset","dataset_id":"P4499","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 P4499 (the n1/n2 dimension combination): 1735201=reintegration units per 100 thousand population [pcs].","enum_values":["1735201"]},{"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":2016,"value":3.1,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2017,"value":3.1,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2018,"value":3.3,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2019,"value":3.4,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2020,"value":3.4,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2021,"value":3.3,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2022,"value":3.3,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"},{"year":2023,"value":3.3,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1735201"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/1735201?page-size=10&format=json&lang=en","curl":"curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1735201?page-size=10&format=json&lang=en'","label":"Values of one variable across territorial units","method":"GET","description":"Yearly values of variable 1735201 (reintegration units per 100 thousand population [pcs]) 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-02T15:31:24.699Z","run_id":"f84602ba-3fb7-43b3-b435-6143f889b4be","created_at":"2026-07-25T18:21:51.639Z","updated_at":"2026-09-02T15:31:24.699Z","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":"f25033525c34b6a02b04afbeb4be16da69f58cb90f6d5b8b4c215aec62295a2e","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-08T21:51:55.148Z","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."}}