{"id":"5cb8a0e5-5522-48c2-82ae-bf538fcad7fe","type":"API","name":"Reintegration units by lead entity","slug":"reintegration-units-by-lead-entity","description":"SOCIAL ECONOMY › REINTEGRATION UNITS. Local Data Bank (BDL) subject P4054: 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#P4054","extraction_confidence":"0.40","created_at":"2026-07-25T14:44:14.763Z","updated_at":"2026-09-06T04:37:56.071Z","last_verified_at":"2026-09-06T01:13:02.038Z","deprecated_at":null,"ranking_score":58,"last_ranked_at":"2026-08-30T11:45:48.841Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-28T02:22:58.798Z","search_vector":"'bank':12B,41B 'bdl':13B,42B 'by':32A,56B 'data':11B,40B 'economi':7B 'economy':36B 'entiti':5A 'entity':34A 'for':48B 'gmina':23B,52B 'id':29B 'ids':58B 'key':26B 'keyed':55B 'lead':4A,33A 'level':24B,53B 'local':10B,39B 'p4054':15B,44B 'poland':20B,49B 'reintegr':1A,8B 'reintegration':30A,37B 'seri':18B 'series':47B 'social':6B,35B 'subject':14B,43B 'territori':17B 'territorial':46B 'teryt':28B,57B 'to':51B 'unit':2A,9B,25B 'units':31A,38B,54B 'voivodship':21B,50B 'year':16B 'yearly':45B","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-26T20:04:00.000Z","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#P4054|reintegration units by lead entity","upstream_ref":"bdl.stat.gov.pl:subject:P4054","access":{"level":"direct","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P4054","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://bdl.stat.gov.pl/api/v1/subjects/P4054","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/1621794?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#P4054","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"5cb8a0e5-5522-48c2-82ae-bf538fcad7fe","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-09T00:50:44.615Z"},"api_details":{"id":"8c43c88e-6183-43e7-a906-dd38430a2432","entry_id":"5cb8a0e5-5522-48c2-82ae-bf538fcad7fe","base_url":"https://bdl.stat.gov.pl/api/v1/subjects/P4054","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/P4054","created_at":"2026-07-25T14:44:14.927Z","updated_at":"2026-07-25T14:44:14.927Z"},"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":"93c7988c-902e-4f5d-9714-6ceced671ad4","entry_id":"5cb8a0e5-5522-48c2-82ae-bf538fcad7fe","status":"VERIFIED","last_checked_at":"2026-09-06T01:13:01.747Z","p50_latency_ms":3089,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-27T06:41:56.472Z","updated_at":"2026-09-06T01:13:01.747Z","consecutive_successes":8,"probe_url":"https://bdl.stat.gov.pl/api/v1/subjects/P4054","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json; charset=utf-8","probe_succeeded_at":"2026-09-06T01:13:01.747Z"},"data_profile":{"id":"48c8b6ee-d689-40ea-93ab-a30e8acfdf25","entry_id":"5cb8a0e5-5522-48c2-82ae-bf538fcad7fe","profile_source":"bdl","profile_kind":"dataset","dataset_id":"P4054","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 P4054 (the n1/n2 dimension combination): 1621794=Social integration centers / total [pcs]; 1621795=Social integration centers / total [%]; 1621796=Social integration centers / non-profit organizations [pcs]; 1621797=Social integration centers / non-profit organizations [%]; 1621798=Social integration centers / associations [pcs]; 1621799=Social integration centers / associations [%]; 1621800=Social integration centers / foundations [pcs]; 1621801=Social integration centers / foundations [%]; 1621802=Social integration centers / faith-based charities [pcs]; 1621803=Social integration centers / faith-based charities [%]; 1621804=Social integration centers / local government units [pcs]; 1621805=Social integration centers / local government units [%]; 1621806=Social integration centers / social cooperatives [pcs]; 1621807=Social integration centers / social cooperatives [%]; 1621857=Social integration centers / other entities [pcs]; … (60 variables — GET https://bdl.stat.gov.pl/api/v1/variables?subject-id=P4054 for the full list).","enum_values":["1621794","1621795","1621796","1621797","1621798","1621799","1621800","1621801","1621802","1621803","1621804","1621805","1621806","1621807","1621857","1621858","1621808","1621809","1621810","1621811","1621812","1621813","1621814","1621815","1621816","1621817","1621818","1621819","1621820","1621821","1621822","1621823","1621824","1621825","1621826","1621827","1621828","1621829","1621830","1621831","1621832","1621833","1621861","1621862","1621836","1621837","1621838","1621839","1621840","1621841","1621842","1621843","1621844","1621845","1621846","1621847","1621848","1621849","1621863","1621864"],"description_en":"GUS variable id selecting the measured reintegration-unit series and lead-entity type."},{"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"],"description_en":"Territorial aggregation level, from 0=Poland to 6=gmina."},{"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.","description_en":"Reference year of the reported value."},{"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).","description_en":"12-digit BDL code identifying the territorial unit."},{"name":"unit_name","type":"string","label":null,"description":null,"description_en":"Name of the territorial unit, e.g. country, voivodship, or gmina."},{"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).","description_en":"TERYT TERC territorial code corresponding to the unit."},{"name":"value","type":"number","label":null,"description":null,"description_en":"Measured value of the selected reintegration-unit variable."},{"name":"attr_id","type":"integer","label":null,"description":"GUS value-attribute id (data quality/annotation flag).","description_en":"GUS data-quality or annotation flag for the value."}],"field_count":8,"sample_records":[{"year":2016,"value":159,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2017,"value":166,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2018,"value":186,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2019,"value":186,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2020,"value":193,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2021,"value":201,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2022,"value":208,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"},{"year":2023,"value":208,"attr_id":1,"unit_id":"000000000000","unit_name":"POLAND","teryt_terc":null,"unit_level":null,"variable_id":"1621794"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bdl.stat.gov.pl/api/v1/data/by-variable/1621794?page-size=10&format=json&lang=en","curl":"curl -s 'https://bdl.stat.gov.pl/api/v1/data/by-variable/1621794?page-size=10&format=json&lang=en'","label":"Values of one variable across territorial units","method":"GET","description":"Yearly values of variable 1621794 (Social integration centers / total [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-04T12:16:47.979Z","run_id":"911b097f-af31-4f5b-904d-9725893defb2","created_at":"2026-07-25T14:55:08.577Z","updated_at":"2026-09-04T12:16:47.979Z","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":"64d7741e51f4d01bec64adc5127e5d2671ed2ecb2838b5826c56215cdc2ded21","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-09T00:51:33.119Z","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."}}