SchoolScout API
ContactsContactidEmails

Get generated emails for contact

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

GET
/contacts/{contactId}/emails

Get previously generated AI outreach emails. Parent district/school must be unlocked, and contact must be 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

Query Parameters

limit?integer
Default50
Rangevalue <= 200
offset?integer
Default0

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08/emails"
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "contact_id": "550e8400-e29b-41d4-a716-446655440000",
      "email_prompt_id": "550e8400-e29b-41d4-a716-446655440000",
      "subject": "string",
      "body": "string",
      "status": "generated",
      "generation_metadata": {
        "property1": null,
        "property2": null
      },
      "generated_at": "string",
      "created_at": "string",
      "prompt_name": "string",
      "contact_name": "string",
      "contact_email": "string"
    }
  ],
  "pagination": {
    "total": -9007199254740991,
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "has_more": true
  }
}
{
  "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
}

Get contact details GET

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).**

Enrich contact data POST

Queue a LinkedIn enrichment job for a contact. Adds profile summary, key facts, photo. Parent district/school must be unlocked, and contact must be unlocked.