Get One Research Run

GET

https://api.aventure.vc/v1/research-runs/:runId

GET

/v1/research-runs/:runId

curl https://api.aventure.vc/v1/research-runs/runId \
     -H "Authorization: Bearer <token>"

{
  "run": {
    "attempt": 1,
    "chassis": "claude-agent-sdk",
    "chassisRouted": true,
    "createdAt": "2024-01-15T09:30:00Z",
    "environment": "unassigned",
    "hasSourceDocument": true,
    "id": "string",
    "iteration": 1,
    "lane": "interactive",
    "llmApi": "anthropic",
    "maxIteration": 1,
    "maxScoutConcurrent": 1,
    "mode": "COMPREHENSIVE",
    "model": "string",
    "status": "queued",
    "subagentModel": "string",
    "type": "ENRICHMENT",
    "updatedAt": "2024-01-15T09:30:00Z",
    "url": "string",
    "entitySlug": "string",
    "error": "string",
    "failureClass": "string",
    "finishedAt": "2024-01-15T09:30:00Z",
    "latestStatus": "string",
    "nextAttemptAt": "2024-01-15T09:30:00Z",
    "resumeSafeUntil": "2024-01-15T09:30:00Z",
    "startedAt": "2024-01-15T09:30:00Z",
    "taskPresetKey": [
      "string"
    ],
    "userPrompt": "string"
  },
  "entity": {
    "id": "string",
    "image": {
      "isMonogram": true,
      "logo": "string",
      "logoSquare": "string"
    },
    "nameAlias": [
      {
        "name": "Bun",
        "displayable": true,
        "type": "alternativeDba"
      }
    ],
    "nameBrand": "string",
    "slug": "aventure-vc",
    "typeRecord": "Company",
    "defaultCurrency": "string",
    "foundedYear": 1,
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "nameLegal": "string",
    "operatingStatus": "string",
    "publicId": "eV1StGXR8Z5a",
    "publicUrl": "string",
    "sitemap": {
      "hasAnalysis": true,
      "hasEmployees": true,
      "hasFundraising": true,
      "hasNews": true,
      "productServiceSlug": [
        "string"
      ],
      "hasAcquisitions": false
    },
    "updatedAt": "2024-01-15T09:30:00Z"
  },
  "latestStatus": {
    "complete": true,
    "entitySlug": "aventure-vc",
    "gateRemaining": [
      "string"
    ],
    "whatElseRemaining": [
      "string"
    ],
    "writeThisIteration": [
      "string"
    ],
    "note": "string"
  },
  "provider": {
    "id": "string",
    "image": {
      "isMonogram": true,
      "logo": "string",
      "logoSquare": "string"
    },
    "nameAlias": [
      {
        "name": "Bun",
        "displayable": true,
        "type": "alternativeDba"
      }
    ],
    "nameBrand": "string",
    "slug": "aventure-vc",
    "typeRecord": "Company",
    "defaultCurrency": "string",
    "foundedYear": 1,
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "nameLegal": "string",
    "operatingStatus": "string",
    "publicId": "eV1StGXR8Z5a",
    "publicUrl": "string",
    "sitemap": {
      "hasAnalysis": true,
      "hasEmployees": true,
      "hasFundraising": true,
      "hasNews": true,
      "productServiceSlug": [
        "string"
      ],
      "hasAcquisitions": false
    },
    "updatedAt": "2024-01-15T09:30:00Z"
  },
  "publicUrl": "string"
}

Returns one of your research runs with its status, latest progress, and, once available, the resulting profile and its public URL.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

runIdstringRequiredformat: "uuid"

Research run id

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

runobject

The research run

entityobject or nullOptional

Current public profile the run resolved to

latestStatusobject or nullOptional

Latest research progress; null when none is available

providerobject or nullOptional

Parent organization’s core record when the resolved entity is a Product/Service; null for every other entity type

publicUrlstring or nullOptionalformat: "uri"

Exact renderable public profile URL for the resolved entity

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error