People

List people

Returns a paginated list of people discovered in your workspace's meeting transcripts, sorted by name ascending.

<Note>The Memory API is in private beta. Requests from non-enrolled workspaces return a 404.</Note>

get/people

Request

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

Query parameters

workspace_idstring required
Example:wks_01k6a2r9s8x7c2dvq3m5n6p4ab

Workspace ID, beginning with wks_. Treat it as an opaque string. Integer workspace ids are still accepted.

searchstring

Full-text search across name, full name, and email fields.

emailstring

Filter to the person with this exact email address (case-insensitive).

company_idinteger

Filter to people who belong to the company with this ID.

pageinteger

Page number to retrieve.

per_pageinteger

Number of results per page. Maximum 100.

Response

A paginated list of people.

Example response

{
  "results": [
    {
      "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.