POST /api/radon/institutions
Price: 1 credit
Get one university, research institution or federation from Poland's national higher-education register by its id: registry numbers, kind, status and type with their history, address, website, e-mail, phone, head, supervising ministry, branches, federation members and transformations
Read one institution by an id from radon/institutions/search or a programme's main_institution.id. Names and labels are in Polish.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)institution string required — Institution id (examples: "5011bcd5-dfb1-41ed-84b0-5bd51ce0832c")@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 — No institution with that id is in the register. 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.