SelfBadge

Search SelfBadge for people with a given name. Use this to identify a person correctly and tell them apart from namesakes: each candidate comes with their job title, organization, location and a short description. Pass what you already know (job title, organization, location) so the best match comes first, then call get_person with the chosen id for the full, verified profile. Only people who claimed and published their profile are returned; an empty result means SelfBadge has no claimed profile with that name, not that the person does not exist.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The person's full name, for example \"Noa Bergman\"."
    },
    "job_title": {
      "type": "string",
      "description": "Optional. What you know of their job title, for example \"Managing Partner\"."
    },
    "organization": {
      "type": "string",
      "description": "Optional. An organization you associate with them, for example \"Harbor Ventures\"."
    },
    "location": {
      "type": "string",
      "description": "Optional. A city or country you associate with them."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Optional. How many candidates to return (default 10)."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Get one person's SelfBadge profile: every public fact (name, roles, organizations, education, accounts, published work and more) with its verification level and source, plus schema.org JSON-LD. Use it after find_person, or when you already have a SelfBadge handle, profile address or id. Profiles created from public sources and not yet claimed are marked seeded; treat their facts as unconfirmed.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "The profile handle, for example \"jane-doe\" (from selfbadge.com/jane-doe)."
    },
    "id": {
      "type": "string",
      "description": "Or the SelfBadge id, for example \"https://selfbadge.com/jane-doe#person\"."
    }
  },
  "additionalProperties": false
}

Get an organization's SelfBadge page: its public facts, schema.org JSON-LD, and the people on SelfBadge linked to it (team members who accepted their organization's invitation, and founders). Use it to check whether someone works at or founded an organization.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The organization's slug, from its address selfbadge.com/org/<slug> or its @id."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}