List Analyses
GET
/v1/analysis/communities/{communityId}/channels/{channelId}
What this endpoint does
chartsEnabled; a channel can list analyses as empty and still reject create.INFO
GET /v1/channels for _id → GET /v1/analysis/communities/{communityId}/channels/{channelId} → if you need to post, the channel must have chartsEnabled: true outside this list.Quick start
Authentication and permission
sendMessage; this list is a GET. Keep the key server-side.Complete examples
message is Analyses fetched successfully. Envelope { status: "success", statusCode: 200, message, data: { analyses, pagination } }.page, limit, total, totalPages, hasNextPage, hasPrevPage. Empty analyses is success.?direction=bullish is valid.?direction=BULLISH returns List Analyses Request Validation validation error. detail.direction: Invalid enum value. Expected 'bullish' | 'bearish' | 'all', received 'BULLISH'.status query expects Pending | Active | Expired | Cancelled | all. status=Hit is rejected.Success and readback
200. Repeat after create/delete. This GET is the list readback.Errors and recovery
| Status | When | Recovery |
|---|---|---|
400 direction enum | BULLISH or other casing | Send bullish, bearish, or all. |
401 | Missing or invalid token | Add a valid community key. |
Retry safety
TIP
Gotchas
metadata.direction is BULLISH or BEARISH (different enum).Next steps
Request
Path Params
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://adss-integration.returning.ai/apis/v1/analysis/communities/6502c9e514a3e564c5c09c0a/channels/656966caae59563fb291b324?limit=20&page=1&status=Pending&timeframe=H1&direction=BULLISH'Response Response Example
200 - Success Example
{
"status": "success",
"message": "Analyses retrieved successfully",
"data": {
"analyses": [
{
"analysisId": "507f1f77bcf86cd799439022",
"title": "EURUSD Bullish Bounce",
"symbol": "EURUSD",
"direction": "BULLISH",
"status": "Pending",
"createdAt": "2025-01-09T12:00:00Z",
"updatedAt": "2025-01-09T12:00:00Z"
}
],
"pagination": {
"total": 45,
"limit": 10,
"offset": 0,
"hasMore": true
}
}
}Modified at 2026-08-19 13:46:05