> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Organization

> Get an organization by ID

Retrieves a specific organization by its ID. The authenticated user must be a member of the organization.

## Path Parameters

<ParamField path="organizationId" type="string" required>
  Organization ID
</ParamField>

## Response

Returns the Organization object.

```json theme={null}
{
  "id": "org123",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "description": "Acme Corporation main organization",
  "status": "active",
  "settings": {
    "timezone": "America/New_York",
    "locales": ["en-US", "es-ES"],
    "features": {
      "assetOptimization": true,
      "advancedPermissions": true
    }
  },
  "roles": {
    "role123": "Editor",
    "role456": "Viewer"
  },
  "metadata": {
    "createdBy": "user123",
    "maxProjects": 10
  },
  "subscription": {
    "tierId": "tier_pro",
    "status": "active",
    "currentPeriodStart": "2024-03-01T00:00:00Z",
    "currentPeriodEnd": "2024-04-01T00:00:00Z"
  },
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-03-20T10:00:00Z"
}
```

## Error Responses

### Organization Not Found

```json theme={null}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Organization org123 was not found"
  }
}
```

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.metabind.ai/app/v1/organizations/org123" \
    -H "Authorization: Bearer YOUR_JWT"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.metabind.ai/app/v1/organizations/org123',
    {
      headers: {
        'Authorization': 'Bearer YOUR_JWT'
      }
    }
  );

  const organization = await response.json();
  console.log(`Organization: ${organization.name}`);
  console.log(`Subscription tier: ${organization.subscription.tierId}`);
  ```

  ```swift Swift theme={null}
  let url = URL(string: "https://api.metabind.ai/app/v1/organizations/org123")!
  var request = URLRequest(url: url)
  request.setValue("Bearer YOUR_JWT", forHTTPHeaderField: "Authorization")

  let (data, _) = try await URLSession.shared.data(for: request)
  let organization = try JSONDecoder().decode(Organization.self, from: data)
  print("Organization: \(organization.name)")
  ```

  ```kotlin Kotlin theme={null}
  val response = client.get("https://api.metabind.ai/app/v1/organizations/org123") {
      header("Authorization", "Bearer YOUR_JWT")
  }

  val organization = response.body<Organization>()
  println("Organization: ${organization.name}")
  println("Subscription tier: ${organization.subscription.tierId}")
  ```
</CodeGroup>