# Retrieve organization

Retrieve detailed information about a specific organization. User must be a member of the organization.

## Path Parameters

**`organization_id`** string required

The unique identifier of the organization (e.g., `org_abc123def456`).

## Returns

An [OrganizationResponse](#organizationresponse) object with full organization details including relationships.

Request

```bash cURL
curl "https://api.aitronos.com/v1/organizations/org_abc123def456" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
organization_id = "org_abc123def456"

response = requests.get(
    f"https://api.aitronos.com/v1/organizations/{organization_id}",
    headers={"X-API-Key": api_key}
)

organization = response.json()
print(organization)
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const organizationId = 'org_abc123def456';

const response = await fetch(
  `https://api.aitronos.com/v1/organizations/${organizationId}`,
  {
    headers: {
      'X-API-Key': apiKey
    }
  }
);

const organization = await response.json();
console.log(organization);
```

Response

```json 200 - OK
{
  "id": "org_abc123def456",
  "name": "Acme Corporation",
  "type": "Work",
  "description": "Main organization",
  "website": "https://acme.com",
  "industry": "Technology",
  "company_size": "50-200",
  "logo_image": null,
  "image_url": "https://api.aitronos.com/v1/icons/icon_abc123",
  "is_active": true,
  "owner_id": "usr_xyz789",
  "api_usage_limit": 1000.0,
  "total_usage_limit": 5000.0,
  "storage_free_bytes_allowance": 10737418240,
  "pricing_tier_id": "tier_standard",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-11-19T14:20:00Z"
}
```


```json 401 - Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "User authentication required",
    "system_message": "Authentication required",
    "type": "client_error",
    "status": 401,
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-17T10:30:00Z"
  }
}
```


```json 403 - Forbidden
{
  "success": false,
  "error": {
    "code": "ORGANIZATION_ACCESS_DENIED",
    "message": "You are not a member of this organization",
    "system_message": "Organization access denied",
    "type": "client_error",
    "status": 403,
    "details": {
      "organization_id": "org_abc123def456"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-17T10:30:00Z"
  }
}
```


```json 404 - Not Found
{
  "success": false,
  "error": {
    "code": "ORGANIZATION_NOT_FOUND",
    "message": "Organization not found",
    "system_message": "Organization not found",
    "type": "client_error",
    "status": 404,
    "details": {
      "organization_id": "org_abc123def456"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-17T10:30:00Z"
  }
}
```