API Documentation

List People

GET /api/v1/people

Get a paginated list of people (persons of interest) in the decentralized identity ecosystem with optional search. Includes thought leaders, executives, researchers, and key contributors.

Request

Query Parameters

Parameter Type Required Default Description
page integer No 1 Page number (1-indexed)
per_page integer No 20 Results per page (1-100)
q string No - Search text for person names

Example Requests

bash 
# Get first page of people
curl -X GET "https://www.weboftrust.org/api/v1/people" \
  -H "X-API-Key: YOUR_API_KEY"

# Search for a specific person
curl -X GET "https://www.weboftrust.org/api/v1/people?q=Kaliya" \
  -H "X-API-Key: YOUR_API_KEY"

# Get page 5 with 100 results per page
curl -X GET "https://www.weboftrust.org/api/v1/people?page=5&per_page=100" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Schema

typescript 
interface PeopleListResponse {
  data: PersonSummary[];
  pagination: {
    page: number;       // Current page (1-indexed)
    per_page: number;   // Items per page
    total: number;      // Total number of people
    total_pages: number; // Total number of pages
  };
}

interface PersonSummary {
  id: number;
  name: string;
  stats: {
    total_links: number; // Number of project/entity connections
  };
}

Example Response

json 
{
  "data": [
    {
      "id": 1082,
      "name": "Stephen Curran",
      "stats": {
        "total_links": 16
      }
    },
    {
      "id": 651,
      "name": "Kaliya Young",
      "stats": {
        "total_links": 13
      }
    },
    {
      "id": 432,
      "name": "Christopher Allen",
      "stats": {
        "total_links": 11
      }
    },
    {
      "id": 987,
      "name": "Drummond Reed",
      "stats": {
        "total_links": 14
      }
    },
    {
      "id": 234,
      "name": "Kim Cameron",
      "stats": {
        "total_links": 8
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5,
    "total": 4532,
    "total_pages": 907
  }
}

Error Responses

400 Bad Request

Invalid query parameters

json 
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid page parameter"
  }
}

500 Internal Server Error

json 
{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch people"
  }
}

Types of People in the Database

Thought Leaders

  • Identity experts and evangelists
  • Privacy advocates
  • Technology visionaries
  • Standards authors

Executives

  • CEOs and founders
  • CTOs and technical leads
  • Government officials
  • Consortium leaders

Researchers

  • Academic researchers
  • Industry analysts
  • Security researchers
  • Privacy researchers

Contributors

  • Open source maintainers
  • Specification editors
  • Community organizers
  • Technical architects

Notable Roles

People may have various roles such as:

  • Project Leadership: CEO, CTO, Director, Chair
  • Technical Roles: Architect, Developer, Researcher
  • Standards Work: Editor, Contributor, Reviewer
  • Advisory: Advisor, Board Member, Consultant
  • Community: Evangelist, Organizer, Advocate

Field Descriptions

  • name: Full name of the person
  • stats.total_links: Number of connections to projects, entities, and standards
    • Higher numbers indicate greater involvement in the ecosystem
    • Includes both current and past affiliations

Privacy Considerations

  • Only public information is included
  • Data sourced from public announcements and documents
  • Focuses on professional roles and contributions
  • No personal contact information provided

Use Cases

  • Network Analysis: Identify key influencers
  • Partnership Discovery: Find experts in specific areas
  • Research: Track thought leadership
  • Due Diligence: Verify leadership claims
  • Event Planning: Identify potential speakers

Search Tips

  • Search by full name for best results
  • Partial name searches are supported
  • Search is case-insensitive
  • Common names may return multiple results

Data Sources

Person information is compiled from:

  • Project announcements
  • Conference speaker lists
  • Standards authorship
  • Company leadership pages
  • Public LinkedIn profiles
  • Industry publications

Performance Notes

  • Results ordered by industry connections (total_links) by default
  • Search operates on full names
  • Large dataset (4500+ people)