People

Retrieve a person

Returns a single person by ID.

get/people/{id}

Request

Base URL
https://www.happyscribe.com/api/v1
Auth
API key in header Authorization

Path parameters

idinteger required

ID of the person.

Response

The person.

idinteger

Unique identifier.

namestring

Display name (typically first name + last initial, or first name alone).

full_namestring

Full name when available.

emailsstring[]

All email addresses recorded for this person, in discovery order.

primary_emailstring

The first email address recorded for this person. Discovery order, not user preference.

job_titlestring nullable

From enrichment. Person enrichment is disabled by default — typically null.

senioritystring nullable

From enrichment. Typically null unless person enrichment is enabled.

headlinestring nullable

From enrichment. Typically null unless person enrichment is enabled.

linkedin_urlstring nullable

From enrichment. Typically null unless person enrichment is enabled.

citystring nullable

From enrichment. Typically null unless person enrichment is enabled.

countrystring nullable

From enrichment. Typically null unless person enrichment is enabled.

photo_urlstring nullable

Full-size photo URL.

avatar_urlstring nullable

Thumbnail avatar URL.

enriched_atstring date-time nullable

Timestamp of the last enrichment run, or null if enrichment has not run.

created_atstring date-time

When it was created, in ISO 8601.

updated_atstring date-time

When it last changed, in ISO 8601.

Example response

{
  "id": 1,
  "name": "Jane Smith",
  "full_name": "Jane Smith",
  "emails": [
    "jane@acme.com",
    "jsmith@acme.com"
  ],
  "primary_email": "jane@acme.com",
  "company": {
    "id": 1,
    "name": "Acme Corp",
    "primary_domain": "acme.com",
    "domains": [
      "acme.com",
      "acme.co"
    ],
    "industry": "Technology",
    "employee_count": 500,
    "founded_year": 2010,
    "short_description": "Project management software for modern teams.",
    "keywords": [
      "saas",
      "productivity",
      "collaboration"
    ],
    "city": "San Francisco",
    "country": "United States",
    "website_url": "https://acme.com",
    "linkedin_url": "https://linkedin.com/company/acme-corp",
    "logo_url": "https://example.com/logo.png",
    "total_funding": null,
    "annual_revenue": null,
    "latest_funding_stage": null,
    "created_at": "2024-01-15T10:00:00.000Z",
    "updated_at": "2024-06-01T12:00:00.000Z",
    "_links": {
      "self": {
        "url": "https://www.happyscribe.com/api/v1/companies/1"
      }
    }
  },
  "job_title": null,
  "seniority": null,
  "headline": "Head of Operations at Acme Corp",
  "linkedin_url": "https://www.linkedin.com/in/janesmith",
  "city": "San Francisco",
  "country": "United States",
  "photo_url": "https://example.com/photo.png",
  "avatar_url": "https://example.com/avatar.png",
  "enriched_at": null,
  "created_at": "2024-01-15T10:00:00.000Z",
  "updated_at": "2024-06-01T12:00:00.000Z",
  "_links": {
    "self": {
      "url": "https://www.happyscribe.com/api/v1/people/1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.