# Project authority status

1 management API operations.

- [GET /v1/projects/{project_id}/authority-status](/docs/api/operations/project_authority_status): Read scoped project authority status

## GET /v1/projects/{project_id}/authority-status

Read scoped project authority status

Read current source review and signed activation observations for an approved project as its current owner or a current project approver. A fresh positive Go readback is an observation, not a lasting sign-in guarantee.

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

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `project_id` | path | string | Yes | Validation: min length 1; max length 128 |
| `limit` | query | integer | No | Validation: minimum 1; maximum 50 |
| `offset` | query | integer | No | Validation: minimum 0; maximum 10000 |

### Request body

This operation has no request body.

### Responses

#### 200

Successful Response

| Field | Variant | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `project_id` |  | string | Yes | Validation: min length 1; max length 128 |
| `observed_at` |  | integer | Yes | Read time, Unix seconds. |
| `lifecycle` |  | LifecycleStatus | Yes |  |
| `activation_effectiveness` |  | unknown | Yes | Project-wide effectiveness remains unknown; inspect each current signed client observation. |
| `clients` |  | ClientAuthorityStatus[] | Yes | Validation: max items 50 |
| `next_offset` |  | integer \| null | Yes | Offset for the next page, or null at the end. |

#### 403

Current project owner or approver authority required.

No fields declared in the current specification.

#### 404

Approved project not found.

No fields declared in the current specification.

#### 409

More rows exist beyond the bounded pagination ceiling.

No fields declared in the current specification.

#### 422

Validation Error

| Field | Variant | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `detail` |  | ValidationError[] | No |  |

### Request examples

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

#### cURL

```sh
curl -X GET 'https://YOUR_IDENTITY_HOST/v1/projects/REPLACE_WITH_PROJECT_ID/authority-status' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

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

```typescript
const response = await fetch('https://YOUR_IDENTITY_HOST/v1/projects/REPLACE_WITH_PROJECT_ID/authority-status', {
  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/projects/REPLACE_WITH_PROJECT_ID/authority-status',
    headers={'Authorization': 'Bearer ' + os.environ['TAIFA_MANAGEMENT_TOKEN']}
)
response.raise_for_status()
```

### Response example

No response example in the current specification.


[Request and response examples](/docs/api/operations/project_authority_status)