SchoolScout API
ContactsContactid

Get contact details

Get full details for a contact. The parent district or school must be unlocked first. PII (email, phone, LinkedIn) is redacted if the contact itself is not yet unlocked. **Free (0 credits).**

GET
/contacts/{contactId}

Get full details for a contact. The parent district or school must be unlocked first. PII (email, phone, LinkedIn) is redacted if the contact itself is not yet unlocked. Free (0 credits).

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Path Parameters

contactId*string
Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "district_id": "550e8400-e29b-41d4-a716-446655440000",
  "school_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "string",
  "title": "string",
  "email": "string",
  "phone": "string",
  "state": "string",
  "is_district_contact": true,
  "linkedin_url": "string",
  "profile_summary": "string",
  "key_facts": {
    "property1": null,
    "property2": null
  },
  "source": "string",
  "source_url": "string",
  "enrichment_status": "pending",
  "enriched_at": "string",
  "enrichment_error": "string",
  "enrichment_retry_count": -9007199254740991,
  "qualification_score": 0,
  "qualification_justification": "string",
  "qualified_at": "string",
  "email_status": "pending",
  "email_error": "string",
  "email_retry_count": -9007199254740991,
  "emailed": true,
  "emailed_at": "string",
  "email_bounced": true,
  "email_bounced_at": "string",
  "email_confidence_score": -9007199254740991,
  "email_verification_status": "string",
  "email_verified_at": "string",
  "hubspot_contact_id": "string",
  "hubspot_synced_at": "string",
  "hubspot_sync_status": "pending",
  "hubspot_sync_error": "string",
  "notes": "string",
  "discovered_at": "string",
  "last_updated_at": "string",
  "created_at": "string",
  "_access": {
    "is_unlocked": true,
    "is_scouting": true,
    "unlocked_at": "string",
    "credits_spent": 0,
    "unlock_cost": 0
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "PARENT_ENTITY_LOCKED",
  "message": "string",
  "parent_entity_type": "district",
  "parent_entity_id": "550e8400-e29b-41d4-a716-446655440000",
  "unlock_cost": 0
}
Empty

Search contacts GET

Search contacts with parent-first access gating. Returns two sections: `data` contains full contact records at unlocked parent districts/schools (PII gated per contact unlock); `_locked_parent_contacts` summarizes how many additional contacts match at locked parent entities, with names and unlock costs. Unlock a parent district/school to move its contacts into `data`. **Free (0 credits).**

Get generated emails for contact GET

Get previously generated AI outreach emails. Parent district/school must be unlocked, and contact must be unlocked. **Free (0 credits).**