> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyke.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Fetch connection status
> Check the connection status between the current user and another user
## Overview
Returns a function that fetches the full connection status between the current authenticated user and a target user. Returns a discriminated union based on the current state: `"none"`, `"pending"`, `"connected"`, or `"declined"`.
`useConnectionManager` calls this automatically on mount. Use this hook directly when you need one-off status checks without managing state.
## Usage Example
```tsx theme={null}
import { useFetchConnectionStatus } from "@replyke/react-js";
function ProfilePage({ userId }: { userId: string }) {
const fetchConnectionStatus = useFetchConnectionStatus();
useEffect(() => {
fetchConnectionStatus({ userId }).then((status) => {
console.log(status.status); // "none" | "pending" | "connected" | "declined"
});
}, [userId]);
}
```
## Parameters
The hook returns a function. That function accepts:
The ID of the user to check. Cannot be the current user's own ID.
## Returns
Returns a `ConnectionStatusResponse` — a discriminated union based on `status`:
**When `status === "none"`:**
No connection exists.
**When `status === "pending"`:**
A connection request is pending.
Direction from the current user's perspective.
The connection record ID.
ISO timestamp when the request was created.
**When `status === "connected"`:**
Connection is established.
The connection record ID.
ISO timestamp when the connection was established.
ISO timestamp when the request was originally sent.
**When `status === "declined"`:**
A connection request was declined.
Direction of the original request.
The connection record ID.
ISO timestamp when the request was declined.
## Related
* [useConnectionManager](/hooks/connections/use-connection-manager) — loads this status automatically