> ## Documentation Index
> Fetch the complete documentation index at: https://docs.messari.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Deep Research Job

> Returns the current status of a deep research job. When status is 'completed', the response includes the generated report and sources.



## OpenAPI

````yaml GET /ai/v1/deep-research/{id}
openapi: 3.0.0
info:
  description: OpenAPI specification for Messari Deep Research API
  title: Messari API - Deep Research V1
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /ai/v1/deep-research/{id}:
    get:
      summary: Get deep research job status and result
      description: >-
        Returns the current status of a deep research job. When status is
        'completed', the response includes the generated report and sources.
        Poll this endpoint to check progress.
      operationId: getDeepResearch
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  created_at:
                    description: Unix timestamp when the job was created
                    format: int64
                    type: integer
                  error:
                    allOf:
                      - $ref: '#/components/schemas/DeepResearchError'
                      - description: Error details, populated when status is 'failed'
                  job_id:
                    description: Unique identifier for the deep research job
                    format: byte
                    type: string
                  model:
                    description: Model used for the deep research
                    type: string
                  object:
                    description: Type of object returned, always 'deep_research'
                    type: string
                  output:
                    allOf:
                      - $ref: '#/components/schemas/DeepResearchOutput'
                      - description: >-
                          The research output, populated when status is
                          'completed'
                  query:
                    description: The research query that was submitted for this job
                    type: string
                  status:
                    description: >-
                      Current status of the deep research job: queued,
                      in_progress, completed, failed, cancelled
                    type: string
                required:
                  - created_at
                  - job_id
                  - model
                  - object
                  - query
                  - status
                type: object
          description: Default response
        '400':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Internal Server Error
      security:
        - apiKey: []
components:
  schemas:
    DeepResearchError:
      properties:
        code:
          description: >-
            A machine-readable error code: insufficient_credits, timeout,
            internal_error, cancelled
          type: string
        message:
          description: A human-readable error message describing the failure
          type: string
      required:
        - code
        - message
      type: object
    DeepResearchOutput:
      properties:
        report:
          description: The generated deep research report in markdown format
          type: string
        sources:
          description: Sources cited in the report
          items:
            $ref: '#/components/schemas/DeepResearchSource'
          type: array
      required:
        - report
      type: object
    DeepResearchSource:
      properties:
        citationId:
          format: int64
          type: integer
        domain:
          type: string
        title:
          type: string
        url:
          type: string
      type: object
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````