> ## 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.

# Create Deep Research Job

> Start a new deep research report generation. The job runs asynchronously and typically takes 5-10 minutes to complete.



## OpenAPI

````yaml POST /ai/v1/deep-research
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:
    post:
      summary: Create a deep research job
      description: >-
        Starts a new deep research report generation. The job runs
        asynchronously and typically takes 5-10 minutes to complete. Use the
        returned job ID to poll for status and results via GET
        /v1/deep-research/:id. Consumes 500 credits. Enterprise teams receive 10
        free report generations per month (shared with the Messari platform)
        which are consumed before credits. Optionally provide a job_id to send a
        follow-up message for iterative refinement of an existing report.
      operationId: postDeepResearch
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/DeepResearchRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  created_at:
                    description: Unix timestamp when the job was created
                    format: int64
                    type: integer
                  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
                  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:
    DeepResearchRequest:
      properties:
        instructions:
          description: >-
            Optional system instructions to guide the research process and
            report generation style
          type: string
        job_id:
          description: >-
            Optional UUID of an existing deep research conversation to continue
            with a follow-up message
          format: byte
          type: string
        query:
          description: The research query or topic for the deep research report
          type: string
      required:
        - query
      type: object
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````