openapi: 3.1.0
info:
  title: Diamond Search IDEX Data API - Report 3 Fullfeed API
  description: API for retrieving data report 3 in CSV format.
  version: 1.0.0
servers:
- url: https://api.idexonline.com/idexdataapi/api
tags:
- name: Fullfeed
paths:
  /fullfeed:
    post:
      summary: Diamond Search Retrieve Full Feed of Diamonds
      description: Fetches a file with full details of matching pre-filtered diamonds in the requested format.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                authentication_details:
                  type: object
                  properties:
                    api_key:
                      type: string
                      example: HNNSSA1223311
                    api_secret:
                      type: string
                      example: DDccdaaedf123
                  required:
                  - api_key
                  - api_secret
                parameters:
                  type: object
                  properties:
                    file_format:
                      type: string
                      example: csv
                      enum:
                      - csv
                    data_format:
                      type: string
                      example: format_20220530_extended
                      enum:
                      - format_20220525_basis
                      - format_20220530_extended
                      - format_20221026_extended
                      - format_20230628_extended
                    create_zip_file:
                      type: boolean
                      example: true
                      default: true
                  required:
                  - file_format
                  - data_format
              required:
              - authentication_details
              - parameters
      responses:
        '200':
          description: Successful response with file download or JSON data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  file:
                    type: string
                    description: File content or download URL.
        '500':
          description: Error occurred during processing.
          content:
            application/json:
              schema:
                type: object
                properties:
                  result_info:
                    type: object
                    properties:
                      response_code:
                        type: integer
                        example: 32110
                      response_description:
                        type: string
                        example: A description of the exception.
                    required:
                    - response_code
                    - response_description
      tags:
      - Fullfeed