Skip to main content
GET
/
research
/
{task_id}
Get research status and results
curl --request GET \
  --url https://api.rapportapi.com/research/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "prospect_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "processing_time_seconds": 123,
  "report_url": "<string>",
  "result": {
    "status": "success",
    "overall_confidence": "HIGH",
    "outreach_intelligence": {
      "icebreakers": [
        {
          "angle": "<string>",
          "opening_line": "<string>",
          "why_effective": "<string>",
          "source_type": "<string>",
          "confidence": "HIGH",
          "topic_category": "<string>"
        }
      ],
      "communication_style": "<string>",
      "best_approach": "<string>",
      "topics_to_avoid": [
        "<string>"
      ]
    },
    "professional": {
      "current_title": "<string>",
      "current_company": "<string>",
      "current_location": "<string>",
      "industry": "<string>",
      "skills": [
        "<string>"
      ],
      "achievements": [
        "<string>"
      ]
    },
    "personal": {
      "interests": [
        "<string>"
      ],
      "hobbies": [
        "<string>"
      ],
      "sports_teams": [
        "<string>"
      ],
      "causes": [
        "<string>"
      ],
      "memberships": [
        "<string>"
      ]
    },
    "education": {
      "entries": [
        {
          "institution": "<string>",
          "degree": "<string>",
          "field_of_study": "<string>",
          "graduation_year": 123
        }
      ],
      "certifications": [
        "<string>"
      ]
    },
    "family": {
      "children_count": 123,
      "pets": [
        "<string>"
      ]
    },
    "social_media": {
      "linkedin": {
        "url": "<string>",
        "bio": "<string>",
        "post_count": 123,
        "posts_summary": "<string>"
      },
      "twitter": {
        "url": "<string>",
        "bio": "<string>",
        "twitter_posts_summary": "<string>"
      }
    }
  },
  "error": "<string>"
}

Authorizations

Authorization
string
header
required

API key with rapi_live_ prefix

Path Parameters

task_id
string<uuid>
required

The task ID returned from POST /research

Response

Task status and results

task_id
string<uuid>
status
enum<string>

Current task status

Available options:
pending,
running,
completed,
failed
prospect_id
string | null
created_at
string<date-time>
started_at
string<date-time> | null
completed_at
string<date-time> | null
processing_time_seconds
number | null
report_url
string<uri> | null

Public URL to the HTML report (only when completed)

result
object

Full intelligence report (only present when status is 'completed')

error
string | null

Error message (only when failed)