> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://documents.pyramid-ai.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://documents.pyramid-ai.com/_mcp/server.

# Organizations

## GET /api/v2/organization

Returns the organization associated with the API key used in the request. Use this to verify your key is configured correctly.

**Authentication:** Bearer token required

| Parameter | Description                       |
| --------- | --------------------------------- |
| *(none)*  | This endpoint takes no parameters |

**Example request:**

```bash
curl https://api.pyramid-ai.com/api/v2/organization \
  -H "Authorization: Bearer pai_live_YOUR_KEY"
```

**Example response** `200 OK`:

```json
{
  "success": true,
  "data": {
    "id": "iPwoNDP1ribwqCTkvlEyiA6DtGZdYe0k",
    "name": "AIS Construction Ltd"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}
```

| Field       | Type   | Description                    |
| ----------- | ------ | ------------------------------ |
| `data.id`   | string | Unique organization identifier |
| `data.name` | string | Organization display name      |

**Error responses:**

| Status | Code           | When                                          |
| ------ | -------------- | --------------------------------------------- |
| `401`  | `UNAUTHORIZED` | Missing or invalid API key                    |
| `404`  | `NOT_FOUND`    | Organization not found (key may be corrupted) |