POST
/
api
/
v2
/
agents
/
qualify-person
/
run
Qualify Person Agent
curl --request POST \
  --url https://app.octavehq.com/api/v2/agents/qualify-person/run \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{
  "email": "john.doe@example.com",
  "jobTitle": "<string>",
  "companyDomain": "example.com",
  "companyName": "<string>",
  "firstName": "<string>",
  "linkedInProfile": "<string>",
  "runtimeContext": "<string>",
  "agentOId": "agent_123"
}'
{
  "_metadata": {
    "usage": 0,
    "requestId": "requestId",
    "message": "message",
    "timestamp": "2021-01-01T00:00:00.000Z"
  },
  "found": true,
  "message": "Additional information",
  "data": {
    "person": {
      "firstName": "<string>",
      "lastName": "<string>",
      "title": "<string>",
      "profileUrl": "<string>",
      "company": {
        "name": "<string>",
        "description": "<string>",
        "domain": "<string>",
        "website": "<string>",
        "founded": 123,
        "location": {
          "region": "<string>",
          "locality": "<string>",
          "postalCode": "<string>",
          "countryCode": "<string>",
          "streetAddress": "<string>"
        },
        "employeeCount": 123,
        "followerCount": 123,
        "type": "<string>",
        "slug": "<string>",
        "logoUrl": "<string>",
        "countryCode": "<string>",
        "specialties": [
          "<string>"
        ],
        "industry": "<string>",
        "crunchBaseFunding": [
          {
            "fundingRoundCount": 123,
            "roundDate": "<string>",
            "roundName": "<string>",
            "investorNames": [
              "<string>"
            ],
            "investorCount": 123,
            "roundAmount": 123,
            "roundCurrency": "<string>"
          }
        ]
      },
      "companyName": "<string>",
      "companyDomain": "<string>",
      "companyFoundedYear": 123,
      "companyEmployeeCount": 123,
      "companyDescription": "<string>",
      "headline": "<string>",
      "summary": "<string>",
      "slug": "<string>",
      "internalPictureUrl": "<string>",
      "countryCode": "<string>",
      "location": "<string>",
      "city": "<string>",
      "currentJobFunction": "<string>",
      "currentSeniority": "<string>",
      "followers": 123,
      "allPositionsCount": 123,
      "currentPositionsCount": 123,
      "positions": [
        {
          "companyName": "<string>",
          "title": "<string>",
          "summary": "<string>",
          "is_current": false,
          "startDate": "<string>",
          "endDate": "<string>",
          "seniority": "<string>",
          "jobFunction": "<string>",
          "company": {
            "name": "<string>",
            "domain": "<string>",
            "founded": 123,
            "employeeCount": 123,
            "description": "<string>",
            "location": {
              "region": "<string>",
              "locality": "<string>",
              "postalCode": "<string>",
              "countryCode": "<string>",
              "streetAddress": "<string>"
            },
            "slug": "<string>"
          }
        }
      ]
    },
    "score": 123,
    "rationale": "<string>",
    "product": {
      "message": "<string>",
      "oId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "qualification": {
        "answers": [
          {
            "answer": "<string>",
            "rationale": "<string>",
            "confidence": "LOW",
            "question": "<string>"
          }
        ],
        "score": 123,
        "rationale": "<string>"
      }
    },
    "persona": {
      "message": "<string>",
      "oId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "qualification": {
        "answers": [
          {
            "answer": "<string>",
            "rationale": "<string>",
            "confidence": "LOW",
            "question": "<string>"
          }
        ],
        "score": 123,
        "rationale": "<string>"
      }
    },
    "segment": {
      "message": "<string>",
      "oId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "qualification": {
        "answers": [
          {
            "answer": "<string>",
            "rationale": "<string>",
            "confidence": "LOW",
            "question": "<string>"
          }
        ],
        "score": 123,
        "rationale": "<string>"
      }
    },
    "playbook": {
      "message": "<string>",
      "oId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "qualification": {
        "answers": [
          {
            "answer": "<string>",
            "rationale": "<string>",
            "confidence": "LOW",
            "question": "<string>"
          }
        ],
        "score": 123,
        "rationale": "<string>"
      }
    }
  }
}

Authorizations

api_key
string
header
required

Body

application/json

Qualify input

The body is of type object.

Response

200
application/json

Qualification successful

The response is of type object.