POST /api/radon/institutions/search
Price: 10 credits
Search the universities, research institutions and federations in Poland's national higher-education register by name, kind, status, university type, research institution type, region, city, NIP, REGON and KRS. Each institution carries its registry numbers, kind, status and type with their history, address, website, e-mail, phone, head, supervising ministry, branches, federation members and transformations
With no filter it lists the whole register, liquidated and transformed institutions included; pass status=operating for current ones. Names and labels are in Polish. Pass a returned id as institution_id to radon/programs/search to list its programmes.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)count integer required — Max number of institutions to return (min: 1; max: 1000)name string nullable — Text contained in the institution name (examples: "Uniwersytet"; minLength: 1)kind string nullable — Institution kind (one of: "public_university", "non_public_university", "ecclesiastical_university", "research_institution", "federation"; examples: "public_university")status string nullable — Institution status (one of: "operating", "in_liquidation", "liquidated", "transformed", "delisted"; examples: "operating")university_type string nullable — University type (one of: "academic", "vocational"; examples: "academic")research_institute_type string nullable — Research institution type (one of: "research_institute", "pan_institute", "international_institute", "other", "lukasiewicz_institute", "academy_of_arts_and_sciences"; examples: "pan_institute")voivodeship string nullable — Voivodeship (one of: "dolnoslaskie", "kujawsko-pomorskie", "lubelskie", "lubuskie", "lodzkie", "malopolskie", "mazowieckie", "opolskie", "podkarpackie", "podlaskie", "pomorskie", "slaskie", "swietokrzyskie", "warminsko-mazurskie", "wielkopolskie", "zachodniopomorskie"; examples: "malopolskie")city string nullable — City, matched whole and case-insensitively (examples: "Warszawa"; minLength: 1)nip string nullable — NIP tax number (examples: "6761011948")regon string nullable — REGON statistical number (examples: "003871913")krs string nullable — KRS court register number (examples: "0000127372")@type string (default: "RadonInstitution")id string requiredpolon_id string nullablepolon_uid string nullablename string nullablename_history array (default: [])@type string (default: "RadonDatedName")name string nullablestart_at integer nullablekind_code string nullablekind string nullablestatus_code string nullablestatus string nullablestatus_history array (default: [])@type string (default: "RadonDatedName")name string nullablestart_at integer nullableuniversity_type_code string nullableuniversity_type string nullabletype_history array (default: [])@type string (default: "RadonDatedName")name string nullablestart_at integer nullableresearch_institute_type_code string nullableresearch_institute_type string nullablestreet string nullablebuilding_number string nullableapartment_number string nullablepostal_code string nullablecity string nullablevoivodeship string nullablevoivodeship_code string nullablecountry string nullablecountry_code string nullableaddresses array (default: [])@type string (default: "RadonAddress")street string nullablebuilding_number string nullableapartment_number string nullablepostal_code string nullablecity string nullablevoivodeship string nullablecountry string nullablestart_at integer nullablewebsite string nullablewebsites array (default: [])website_url string nullableemail string nullablephone string nullablee_delivery_address string nullableepuap_address string nullableregon string nullablenip string nullablekrs string nullableministry_number string nullablepan_number string nullableeun_number string nullablefederation_number string nullableis_state_research_institute boolean nullablestate_research_institute_year integer nullablemanager object nullable@type string (default: "RadonManager")first_name string nullableother_names string nullablelast_name string nullablelast_name_prefix string nullablefunction string nullableemployee_id string nullablesupervising_institution object nullable@type string (default: "RadonNamedInstitution")id string nullablename string nullablesupervising_institutions array (default: [])@type string (default: "RadonSupervisor")id string nullablename string nullablestart_at integer nullablebranches array (default: [])@type string (default: "RadonBranch")id string nullablename string nullablecity string nullablefederation_members array (default: [])@type string (default: "RadonFederationMember")institution_id string nullablename string nullablestart_at integer nullableend_at integer nullabletransformed_institutions array (default: [])@type string (default: "RadonTransformation")institution_id string nullablename string nullablekind string nullabletransformed_at integer nullableregon string nullablenip string nullablekrs string nullablepan_number string nullableeun_number string nullablesupervising_institution_id string nullablesupervising_institution_name string nullabletarget_institutions array (default: [])@type string (default: "RadonTransformation")institution_id string nullablename string nullablekind string nullabletransformed_at integer nullableregon string nullablenip string nullablekrs string nullablepan_number string nullableeun_number string nullablesupervising_institution_id string nullablesupervising_institution_name string nullablestarted_at integer nullableliquidation_started_at integer nullableliquidated_at integer nullableupdated_at integer nullable422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.