> ## Documentation Index
> Fetch the complete documentation index at: https://replyke-feat-push-rich-payload-fields.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Connection Status

> Check connection status with another user

Check the connection status between the current user and the specified user.

***

## Request

### Path Parameters

| Parameter | Type     | Required | Description                                    |
| --------- | -------- | -------- | ---------------------------------------------- |
| `userId`  | `string` | Yes      | ID of the user to check connection status with |

### Headers

| Header          | Type     | Required | Description                      |
| --------------- | -------- | -------- | -------------------------------- |
| `Authorization` | `string` | Yes      | Bearer token for authentication. |

### Body Parameters

*None*

#### Example Request

```http theme={null}
GET /users/user-uuid-123/connection
Authorization: Bearer <ACCESS_TOKEN>
```

***

## Response

### Success Responses

#### No Connection (200 OK)

```json theme={null}
{
  "status": "none"
}
```

#### Pending Request Sent (200 OK)

```json theme={null}
{
  "status": "pending",
  "type": "sent",
  "connectionId": "connection-uuid",
  "createdAt": "2024-01-01T12:00:00.000Z"
}
```

#### Pending Request Received (200 OK)

```json theme={null}
{
  "status": "pending",
  "type": "received",
  "connectionId": "connection-uuid",
  "createdAt": "2024-01-01T12:00:00.000Z"
}
```

#### Connected Users (200 OK)

```json theme={null}
{
  "status": "connected",
  "connectionId": "connection-uuid",
  "connectedAt": "2024-01-01T12:05:00.000Z",
  "requestedAt": "2024-01-01T12:00:00.000Z"
}
```

#### Declined Request - Sent (200 OK)

```json theme={null}
{
  "status": "declined",
  "type": "sent",
  "connectionId": "connection-uuid",
  "respondedAt": "2024-01-01T12:05:00.000Z"
}
```

#### Declined Request - Received (200 OK)

```json theme={null}
{
  "status": "declined",
  "type": "received",
  "connectionId": "connection-uuid",
  "respondedAt": "2024-01-01T12:05:00.000Z"
}
```

### Error Responses

#### Invalid User ID (400 Bad Request)

```json theme={null}
{
  "error": "Invalid userId",
  "code": "connection/invalid-user-id"
}
```

#### Self-Check Attempt (400 Bad Request)

```json theme={null}
{
  "error": "Cannot check connection status with yourself",
  "code": "connection/self-check"
}
```

#### Server Error (500 Internal Server Error)

```json theme={null}
{
  "error": "Internal server error",
  "code": "connection/server-error"
}
```

***

## Notes

* Returns comprehensive connection status information
* Shows direction of connection requests (sent/received)
* Includes relevant timestamps for each status
* Cannot check connection status with yourself
* Rate limiting: 100 requests per 5 minutes