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

# getStatus()

> Reference for the Embedded API getStatus() method.

Use `getStatus()` to inspect the current application state, including authentication, current URL, interaction details, documents, and facts.

<Info>
  Applies to Web Component, Window API, and PostMessage. Examples on this page
  use the Web Component API shape.
</Info>

## Usage

```typescript theme={null}
const status = await api.getStatus();
```

## Prerequisites

* None

## Input validation

* None

## Possible errors

* This action does not typically throw structured error codes.
* In rare cases, partial data may be returned if specific state queries fail.

## Returns

```typescript theme={null}
{
  auth: {
    isAuthenticated: boolean,
    user: {
      id: string,
      email: string
    } | null
  },
  currentUrl: string,
  interaction: {
    id: string,
    title: string,
    state: "planned" | "ongoing" | "paused" | "disconnected" | "ending" | "parsing" | "ended",
    startedAt: string,
    endedAt: string | null,
    endsAt: string | null,
    transcripts: Array<unknown>,
    documents: Array<unknown>,
    facts: Array<unknown>,
    websocketUrl: string
  } | null
}
```

## Notes

* This method is useful for debugging and for checking whether prerequisites are already satisfied.
* `interaction` may be `null` if no interaction is active or if interaction lookup fails.

## Related reference

* [API Reference Overview](/assistant/api-reference)
* [auth()](/assistant/api/auth)
* [createInteraction()](/assistant/api/create-interaction)