API reference
Institutions
GET/v1/institutions
Authentication Bearer access token with audience taifa-management. Roles and local eligibility are reviewed separately from the OpenAPI bearer scheme.
Parameters
No path or query parameters declared.
Request body
This operation has no request body.
Responses
200Successful Response
Content type: application/json(InstitutionForOperator | InstitutionForAdministrator)[]
Required applies within each listed response variant.
| Field | Variant | Type | Required | Description |
|---|---|---|---|---|
[].id | InstitutionForOperator | string | Yes | |
[].name | InstitutionForOperator | string | Yes | |
[].status | InstitutionForOperator | string | Yes | |
[].proposer | InstitutionForOperator | string | Yes | |
[].approver | InstitutionForOperator | string | null | Yes | |
[].evidence_reference | InstitutionForOperator | string | Yes | |
[].can_review_evidence | InstitutionForOperator | true | Yes | |
[].id | InstitutionForAdministrator | string | Yes | |
[].name | InstitutionForAdministrator | string | Yes | |
[].status | InstitutionForAdministrator | string | Yes | |
[].proposer | InstitutionForAdministrator | string | Yes | |
[].approver | InstitutionForAdministrator | string | null | Yes | |
[].can_review_evidence | InstitutionForAdministrator | false | Yes |
Request example
Illustrative only. TypeScript runs in Node.js on the server. Keep management tokens out of browser bundles. Replace the host, token, path values, and any header or required body placeholders before use. Examples do not send requests.
curl -X GET 'https://YOUR_IDENTITY_HOST/v1/institutions' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'Response example
No response example in the current specification.