# Institutions

GET /v1/institutions

Institutions

Authentication: bearer access token with audience `taifa-management`. Endpoint roles and eligibility are reviewed separately from the OpenAPI bearer scheme.

No operation-specific scopes are declared in the OpenAPI document. Bearer authentication and endpoint authorization requirements still apply.

## Parameters

No path or query parameters declared.

## Request body

This operation has no request body.

## Responses

### 200

Successful Response

| 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 examples

Illustrative only. Replace placeholders and keep management tokens on the server.

### cURL

```sh
curl -X GET 'https://YOUR_IDENTITY_HOST/v1/institutions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

### TypeScript (Node.js/server-side)

```typescript
const response = await fetch('https://YOUR_IDENTITY_HOST/v1/institutions', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.TAIFA_MANAGEMENT_TOKEN}`
  }
});

const result = await response.json();
```

### Python

```python
import os
import requests

response = requests.request(
    'GET',
    'https://YOUR_IDENTITY_HOST/v1/institutions',
    headers={'Authorization': 'Bearer ' + os.environ['TAIFA_MANAGEMENT_TOKEN']}
)
response.raise_for_status()
```

## Response example

No response example in the current specification.