Skip to main content
This endpoint is currently in beta. The API response format and behavior may change in future releases.

​
Use Case

Evaluate and qualify data against predefined criteria using autonomous research and structured analysis for sales outreach, CRM enrichment, or lead qualification.

​
Endpoint

POST https://api.sixtyfour.ai/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
The struct field controls which fields appear in the response’s structured_data. Each key is a field name, and its value is a plain-English description of what you want (e.g., "Overall qualification score (0-10)"). You can optionally use an object with description and type for predictable output formats (e.g., {"description": "Score", "type": "int"}). Only fields specified in struct will be included in the response.

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

​
Example Usage

curl -X POST "https://api.sixtyfour.ai/qa-agent" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"
    }
  }'