Returning.AI
  1. Analysis API
Returning.AI
  • Returning.AI
    • APIs
      • Authentication
      • System API
        • Auth
          • Secure Auth
          • register
          • verify email
          • login
        • Server
          • create new server
          • get my servers
          • update server
          • channel list of server
        • Channel
          • get channels list
          • create new channel
          • update channel
          • delete channel
        • Role
          • role list of server
          • create new role
          • update role
          • delete role
          • get role list of user on a server
          • add role to a user on a server
          • remove role from a user on a server
        • Badge
          • get badges list
          • create new badge
          • update badge
          • delete badge
          • award badge to user
          • remove badge from user
      • Application API
        • Community Users
          • Get community users
          • Get user
        • User Fields
          • Get All User Fields
          • Get Specific User Field
          • Create Custom User Field
          • Update Custom User Field
          • Delete Custom User Field
        • User Field Histories
          • Get all user field histories in a community
          • Get user field histories for a specific field
          • Get user field histories for a specific user
          • Get user field histories of specific user field and user
          • Create user field history for specific user
      • Integration API
        • Users
          • Get Users with Filters
          • Create New User
          • Get User Data
          • Manage User Account
          • Get User Gamification History
          • Get User Gamification Stats
          • Bulk Import
          • Bulk Update
          • Get All Bulk Update
          • Check Bulk Update Status
          • Check Bulk Update Details
        • Messages
          • Get Messages
          • Send Message
          • Reply Message
          • React Message
        • Channels
          • Get Channels List
        • Xp Settings
          • Get Tier Info
        • Gamifications
          • Get User Gamification Logs
        • Analysis API
          • Create Analysis
            POST
          • Get Analysis
            GET
          • Update Analysis
            PATCH
          • Delete Analysis
            DELETE
          • List Analyses
            GET
          • Append Drawings
            POST
        • Redemption Transactions
          • Update redemption transaction status
        • Streak Logs
          • Get Streak Logs
    • Channels
      • Iframe
    • Events
      • Outgoing webhooks
        • Encryption
        • User Joins Server
        • User Visits server
        • New Message Posted Anywhere
        • New Message Posted To channel
        • Purchased Store Item
      • Incoming webhooks
        • API Keys & Encryption
        • Send message into channels
        • Update Custom User Fields
        • Update In-game currency
    • Widgets
      • Authenticated Widgets
      • Public widgets
    • Features
  • Schemas
    • Analysis
      • UpdateAnalysisRequest
      • AppendDrawingsRequest
      • CreateAnalysisResponse
      • GetAnalysisResponse
      • UpdateAnalysisResponse
      • AppendDrawingsResponse
      • AnalysisMetadata
      • Expiry
      • Levels
      • LevelEntry
      • Drawing
      • HorizontalLineDrawing
      • LineDrawing
      • RectangleDrawing
      • ParallelDrawing
      • FibonacciRetracementDrawing
      • Coordinate
      • DrawingStyle
      • AnalysisDetail
      • AnalysisSummary
      • CreateAnalysisRequest
      • ListAnalysesResponse
    • Sample Schemas
      • Pet
      • Category
      • Tag
    • Schemas
      • ValidationError
      • NotFoundError
      • InternalServerError
      • NotImplementedError
      • CreateUserFieldHistoryResponse
      • CreateUserFieldHistorySuccessResponse
      • UserFieldHistoryItem
      • GetUserFieldHistoriesResponse
      • UserFieldHistoriesValidationError
      • UserFieldHistoriesMetaWithValidation
      • UserFieldHistoriesMetaWithPagination
      • GetUserFieldHistoriesSuccessResponse
      • CreateUserFieldResponse
      • CreateUserFieldSuccessResponse
      • DeleteUserFieldResponse
      • DeleteUserFieldSuccessResponse
      • UserFieldCreator
      • GetUserFieldResponse
      • GetUserFieldSuccessResponse
      • ValidationErrorItem
      • GetUserFieldsMetaResponse
      • CreatorInfo
      • UserFieldResponse
      • GetUserFieldsSuccessResponse
      • UpdateUserFieldResponse
      • UpdateUserFieldPayload
      • UpdateUserFieldSuccessResponse
      • MetaResponse
      • GetUserResponse
      • GetUserSuccessResponse
    • Outgoing webhooks
      • Purchased store item
      • New message posted to channel
      • User visits server
      • User join server
      • ErrorResponse
  1. Analysis API

Get Analysis

Testing
GET
/apis/v1/analysis/{analysisId}
Fetch a single analysis with full details including levels, drawings, and metadata.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://integration.returning.ai/apis/v1/analysis/6960eaf9294dfdd00c5875bf' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Analysis retrieved successfully
Body

Example
{
    "status": "success",
    "message": "Analysis retrieved successfully",
    "data": {
        "analysisId": "507f1f77bcf86cd799439022",
        "metadata": {
            "direction": "BULLISH",
            "entryPlacement": "ABOVE_CURRENT",
            "expiry": {
                "type": "GTC"
            },
            "title": "EURUSD Bullish Bounce from Support",
            "preferenceText": "Price bounced from [[support_zone:demand zone]]",
            "alternativeText": "string",
            "comments": "string",
            "timeframe": "M1",
            "symbol": "EURUSD"
        },
        "levels": {
            "pivot": {
                "price": 1.09,
                "clientObjectId": "pivot_main",
                "time": "2025-01-09T12:00:00Z"
            },
            "resistance": {
                "price": 1.09,
                "clientObjectId": "pivot_main",
                "time": "2025-01-09T12:00:00Z"
            },
            "support": {
                "price": 1.09,
                "clientObjectId": "pivot_main",
                "time": "2025-01-09T12:00:00Z"
            },
            "intermediateResistance": {
                "price": 1.09,
                "clientObjectId": "pivot_main",
                "time": "2025-01-09T12:00:00Z"
            },
            "intermediateSupport": {
                "price": 1.09,
                "clientObjectId": "pivot_main",
                "time": "2025-01-09T12:00:00Z"
            }
        },
        "drawings": [
            {
                "type": "HORIZONTAL_LINE",
                "clientObjectId": "string",
                "points": [
                    {
                        "time": "2025-01-09T12:00:00Z",
                        "price": 1.09
                    }
                ],
                "style": {
                    "color": "#FF0000",
                    "lineWidth": 2,
                    "lineStyle": "SOLID",
                    "fillColor": "#00FF0033",
                    "borderColor": "#00FF00",
                    "opacity": 1
                }
            }
        ],
        "status": "Pending",
        "createdBy": {
            "userId": "string",
            "username": "string",
            "displayName": "string"
        },
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}
🟠404
🟠401Unauthorized
🔴500InternalServerError
Modified at 2026-01-09 13:14:15
Previous
Create Analysis
Next
Update Analysis