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

# List Invitations

Retrieve a list of all pending invitations for your organization.

### Request

<ParamField header="X-Organization-Id" type="string" required>
  The unique identifier of the organization.
</ParamField>

### Response

<ResponseField name="invitations" type="array">
  List of invitation objects for the organization.

  <Expandable title="Invitation Object">
    <ResponseField name="invite_id" type="string">
      The unique identifier for the invitation.
    </ResponseField>

    <ResponseField name="email" type="string">
      The email address that the invitation was sent to.
    </ResponseField>

    <ResponseField name="client_id" type="string">
      The organization ID associated with the invitation.
    </ResponseField>

    <ResponseField name="role" type="string">
      The role assigned to the invitation.
    </ResponseField>

    <ResponseField name="invited_by" type="string">
      The user ID of the person who created the invitation.
    </ResponseField>

    <ResponseField name="status" type="string">
      The status of the invitation (e.g., `pending`, `accepted`, `cancelled`).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      The timestamp when the invitation was created.
    </ResponseField>

    <ResponseField name="expires_at" type="string">
      The timestamp when the invitation will expire.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "invitations": [
      {
        "invite_id": "inv_xyz789",
        "email": "newuser@example.com",
        "client_id": "org_abc123",
        "role": "user",
        "invited_by": "user_def456",
        "status": "pending",
        "created_at": "2024-03-01T12:00:00Z",
        "expires_at": "2024-03-08T12:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>