Retrieve details of a pending invitation including the shareable invitation link.

#### Path Parameters

**`organization_id`** string required

Organization ID

#### Query Parameters

Provide exactly one of the following:

**`email`** string optional

Email address of the invited user.

**`user_id`** string optional

User ID of the invited user (`usr_` prefixed).

**`invitation_id`** string optional

Invitation ID (`inv_` prefixed).

## Returns

Returns the invitation object with the shareable link.

## Authorization

Requires organization membership.


```bash
# By email
curl -X GET "https://api.aitronos.com/v1/organizations/org_abc123/invitation?email=user@example.com" \
  -H "X-API-Key: $FREDDY_API_KEY"

# By user_id
curl -X GET "https://api.aitronos.com/v1/organizations/org_abc123/invitation?user_id=usr_xyz789" \
  -H "X-API-Key: $FREDDY_API_KEY"

# By invitation_id
curl -X GET "https://api.aitronos.com/v1/organizations/org_abc123/invitation?invitation_id=inv_def456" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import requests
import os

api_key = os.environ["FREDDY_API_KEY"]
org_id = "org_abc123"

# By email
response = requests.get(
    f"https://api.aitronos.com/v1/organizations/{org_id}/invitation",
    headers={"X-API-Key": api_key},
    params={"email": "user@example.com"}
)

invitation = response.json()
```


```javascript
// By email
const response = await fetch(
  'https://api.aitronos.com/v1/organizations/org_abc123/invitation?email=user@example.com',
  {
    headers: {
      'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`
    }
  }
);

const invitation = await response.json();
```

**Response:**

200 OK

```json
{
  "invitation_id": "inv_def456",
  "email": "user@example.com",
  "user_id": "usr_xyz789",
  "organization_id": "org_abc123",
  "role_id": "role_jkl012",
  "invitation_link": "https://chat.aitronos.com/user/register?invite=abc123...",
  "expires_at": "2026-01-12T10:30:00Z",
  "created_at": "2026-01-05T10:30:00Z"
}
```

400 Bad Request

```json
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Exactly one query parameter required: email, user_id, or invitation_id",
    "status": 400
  }
}
```

404 Not Found

```json
{
  "success": false,
  "error": {
    "code": "INVITATION_NOT_FOUND",
    "message": "No pending invitation found",
    "status": 404
  }
}
```