Note: This endpoint is currently in beta. The API response format and behavior may change in future releases.

Evaluate and qualify data against predefined criteria using autonomous research and structured analysis.

Endpoint

POST /qa-agent

Request

Headers

NameTypeRequiredDescription
x-api-keystringYesYour Sixtyfour API key
Content-TypestringYesMust be application/json

Body

FieldTypeRequiredDescription
dataobjectYesPrimary data object to be evaluated and researched
qualification_criteriaarrayYesList of evaluation criteria with weights and thresholds
referencesarrayNoAdditional URLs for research (LinkedIn, Instagram, websites)
structobjectNoDefines output field structure and descriptions

Example Request

{
  "data": {
    "name": "Alex Johnson",
    "country": "United Kingdom",
    "business_type": "e-commerce seller",
    "follower_count": "2500",
    "post_count": "45",
    "instagram_handle": "alexshop_uk"
  },
  "qualification_criteria": [
    {
      "criteria_name": "Physical Inventory",
      "description": "Must own and store physical products for sales",
      "weight": 10.0,
      "threshold": 8.0
    },
    {
      "criteria_name": "Target Market Location",
      "description": "Must be located in UK, Germany, France, or Austria",
      "weight": 8.0
    }
  ],
  "references": [
    {
      "url": "https://www.instagram.com/alexshop_uk",
      "description": "Instagram business profile"
    }
  ],
  "struct": {
    "suitability_score": "Overall qualification score (0-10)",
    "disqualification_reason": "Primary reason for disqualification if applicable",
    "final_verdict": "Clear YES/NO decision",
    "recommendation": "ACCEPT/REJECT with reasoning"
  }
}

Response

Success Response (200)

Returns structured evaluation results with detailed analysis notes.

{
  "structured_data": {
    "suitability_score": "9",
    "disqualification_reason": "",
    "final_verdict": "YES",
    "recommendation": "ACCEPT - Strong inventory-based business in target market"
  },
  "notes": "Research of Alex Johnson, a UK-based e-commerce seller with 2500 Instagram followers, confirms operation of physical inventory business. Located in target market (United Kingdom). Instagram profile shows consistent product posts indicating active sales operations. Business model aligns well with qualification criteria."
}

Error Response (400)

{
  "error": "Bad Request",
  "message": "Missing required field: qualification_criteria"
}

Parameters

qualification_criteria

Each criteria object requires:

  • criteria_name: Unique identifier for the criteria
  • description: Detailed description of what to evaluate
  • weight: Importance multiplier (higher = more important)
  • threshold: Optional minimum score requirement

references

Supported URL types for automatic research:

  • LinkedIn member profiles (https://linkedin.com/in/...)
  • LinkedIn company profiles (https://linkedin.com/company/...)
  • Instagram profiles (https://instagram.com/...)
  • General web pages

struct

Defines output fields that will appear in structured_data. Only specified fields will be included in the response.

Rate Limits

The API is rate limited to 1000 requests per minute per API key.

Example Usage

import requests

response = requests.post(
    'https://api.sixtyfour.ai/qa-agent',
    headers={
        'x-api-key': 'your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        "data": {
            "name": "Alex Johnson",
            "country": "United Kingdom", 
            "business_type": "e-commerce seller",
            "follower_count": "2500"
        },
        "qualification_criteria": [
            {
                "criteria_name": "Physical Inventory",
                "description": "Must own and store physical products",
                "weight": 10.0,
                "threshold": 8.0
            }
        ],
        "struct": {
            "suitability_score": "Overall score (0-10)",
            "final_verdict": "YES/NO decision"
        }
    }
)

results = response.json()