Skip to main content
GET
/
:projectId
/
api
/
v7
/
users
/
:userId
/
connection
Get Connection Status
curl --request GET \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/users/:userId/connection
{
  "status": "<string>",
  "type": "<string>",
  "connectionId": "<string>",
  "createdAt": "<string>",
  "connectedAt": "<string>",
  "requestedAt": "<string>",
  "respondedAt": "<string>"
}

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.

Returns the connection status between the authenticated user and the specified user. The response shape varies depending on whether there is no connection, a pending request, an accepted connection, or a declined request.

​
Path Parameters

​
userId
string
required
The Replyke user ID (UUID) of the other user.

​
Response

On success, returns HTTP 200. The shape depends on the connection state: No connection:
​
status
string
"none".
Pending request:
​
status
string
"pending".
​
type
string
"sent" if the authenticated user sent the request; "received" if they received it.
​
connectionId
string
ID of the connection record.
​
createdAt
string
ISO timestamp of when the request was sent.
Accepted (connected):
​
status
string
"connected".
​
connectionId
string
ID of the connection record.
​
connectedAt
string
ISO timestamp of when the connection was accepted.
​
requestedAt
string
ISO timestamp of the original request.
Declined:
​
status
string
"declined".
​
type
string
"sent" or "received" — perspective of the authenticated user.
​
connectionId
string
ID of the connection record.
​
respondedAt
string
ISO timestamp of when the request was declined.

​
Error Responses

{
  "error": "Cannot check connection status with yourself",
  "code": "connection/self-check"
}

​
See Also