# API tổ chức

Lấy danh sách các tổ chức mà khóa API hiện tại truy cập được.

Source: https://support.toolingmetrics.com/vi/api/reference/organizations/
Updated: 2026-10-29

## Endpoint

```
GET /v1/organizations
```

Trả về một ánh xạ từ tên tổ chức sang ID cho mọi tổ chức mà người sở hữu khóa truy cập được. Chỉ các tổ chức có gói thuê bao đang hoạt động mới được đưa vào (trừ khi người sở hữu khóa là super admin).

## Phản hồi

```json
{
  "Acme Manufacturing": 12,
  "Acme Tooling": 15
}
```

Dùng ID tổ chức dạng số làm đoạn đường dẫn `:organization_id` trong mọi yêu cầu API khác.

## Ví dụ

```bash
curl https://api.toolingmetrics.com/v1/organizations \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```python
import requests

response = requests.get(
    "https://api.toolingmetrics.com/v1/organizations",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
response.raise_for_status()

orgs = response.json()
# {"Acme Manufacturing": 12, "Acme Tooling": 15}

# Get the ID for a specific organization by name
org_id = orgs["Acme Manufacturing"]
```

## Lưu ý

- Endpoint này không cần tham số đường dẫn `organization_id`.
- Phản hồi chỉ liệt kê các tổ chức mà người sở hữu khóa là thành viên.
- Các tổ chức có gói thuê bao không còn hoạt động bị loại ra.