API Documentation

Get Entity Details

GET /api/v1/entities/{id}

Get comprehensive information about a specific entity (organization) including all relationships with projects, people, DID methods, and DLT instances.

Request

Path Parameters

Parameter Type Required Description
id integer Yes Entity ID

Example Request

bash
# Get details for entity ID 649 (European Commission)
curl -X GET "https://www.weboftrust.org/api/v1/entities/649" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Headers

Header Value Description
X-License CC-BY-4.0 License identifier
X-Attribution Web of Trust Map - Key State Capital Required attribution
Cache-Control public, max-age=60, s-maxage=300, stale-while-revalidate=600 Caching directives

Response Schema

typescript
interface EntityDetail {
  // Basic Information
  id: number;
  name: string;
  trade_name?: string;
  type: string[];  // ["Public"] or ["Private"]
  lei?: string;    // Legal Entity Identifier
  website?: string;
  logo_url?: string;
  address?: string;
  country?: {
    id: number;
    name: string;
    code: string;
  };
  coordinates?: {
    latitude: number;
    longitude: number;
  };
  
  // DLT Operations
  operates_dlts?: Array<{
    id: number;
    name: string;
    website?: string;
  }>;
  
  // Project Relationships
  project_relations?: {
    managed?: Array<{
      project: {
        id: number;
        title: string;
        type: string;
        website?: string;
      };
      source?: string;
    }>;
    funded?: Array<{
      project: {
        id: number;
        title: string;
        type: string;
        website?: string;
      };
      source?: string;
    }>;
    affiliated?: Array<{
      project: {
        id: number;
        title: string;
        type: string;
        website?: string;
      };
      source?: string;
    }>;
  };
  
  // Consortium Memberships
  consortium_memberships?: Array<{
    consortium: {
      id: number;
      title: string;
      type: string;
      website?: string;
    };
    source?: string;
  }>;
  
  // People Relationships
  people?: {
    by_person?: Array<{
      person: {
        id: number;
        name: string;
      };
      roles?: string[];
      source?: string;
    }>;
    on_behalf_of?: Array<{
      person: {
        id: number;
        name: string;
      };
      role?: string;
      on_behalf_of_role?: string;
      project?: {
        id: number;
        title: string;
      };
      source?: string;
    }>;
  };
  
  // DID Method Relationships
  did_method_relations?: Array<{
    did_method: {
      id: number;
      name: string;
      specification_url?: string;
    };
    source?: string;
    archived_source?: string;
  }>;
  
  // AI-generated description
  ai_description?: string;
  
  // Statistics
  stats?: {
    total_links: number;
  };
}

Example Response

json
{
  "id": 649,
  "name": "European Commission",
  "trade_name": "European Commission",
  "type": ["Public"],
  "lei": "254900ZNYA1FLUQ9U393",
  "website": "https://commission.europa.eu/index_en",
  "logo_url": "https://weboftrust.org/icons/commission.europa.eu.webp",
  "address": "Rue Belliard 28 (Secondary entrance : Rue de l'Industrie 21), 1000 Bruxelles / Brussel, Belgium",
  "country": {
    "id": 17,
    "name": "Belgium",
    "code": "BE"
  },
  "coordinates": {
    "latitude": 50.8422911,
    "longitude": 4.3703692
  },
  "operates_dlts": [],
  "project_relations": {
    "managed": [
      {
        "project": {
          "id": 289,
          "title": "European Digital Credentials for Learning",
          "type": "DID Project",
          "website": "https://europa.eu/europass/en/europass-tools/european-digital-credentials"
        },
        "source": "https://did-map-resources.s3.amazonaws.com/Northern+Europe/European+Digital+Credentials+for+Learning/PDFs/EDC_presentation_Ilkido_Mazer.pdf"
      },
      {
        "project": {
          "id": 325,
          "title": "EU Digital Identity Wallet",
          "type": "DID Project",
          "website": "https://ec.europa.eu/digital-building-blocks/sites/display/EUDIGITALIDENTITYWALLET/EU+Digital+Identity+Wallet+Home"
        },
        "source": "https://did-map-resources.s3.amazonaws.com/Western+Europe/EU+Digital+Identity+Wallet/ARF_v100_for_publication_SqMV8FwSeE3xg7teicYY4hFDY_93678.pdf"
      }
    ],
    "funded": [
      {
        "project": {
          "id": 286,
          "title": "Billon Platform",
          "type": "DID Project",
          "website": "https://billongroup.com/open-platform"
        },
        "source": "https://archive.ph/gYsE7#selection-1113.0-1113.129"
      }
    ],
    "affiliated": []
  },
  "consortium_memberships": [],
  "people": {
    "by_person": [],
    "on_behalf_of": []
  },
  "did_method_relations": [],
  "ai_description": "The European Commission is the executive branch of the European Union, responsible for proposing legislation, enforcing EU laws, and representing the EU internationally. In the context of digital identity, the Commission has been instrumental in developing the eIDAS regulation and the EU Digital Identity Wallet initiative.",
  "stats": {
    "total_links": 122
  }
}

Error Responses

400 Bad Request

Invalid ID parameter

json
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid entity ID"
  }
}

404 Not Found

Entity not found

json
{
  "error": {
    "code": "not_found",
    "message": "Entity not found"
  }
}

Relationship Types

Project Relations

  • managed: Projects where this entity is the managing organization
  • funded: Projects that this entity provides funding for
  • affiliated: Projects that this entity is affiliated with

People Relations

  • by_person: People who work directly for this entity
  • on_behalf_of: People who represent this entity in projects or consortia

Field Descriptions

  • lei: Legal Entity Identifier - globally unique identifier for legal entities
  • operates_dlts: Blockchain instances that this entity operates
  • consortium_memberships: Consortia where this entity is a member
  • ai_description: AI-generated description providing context about the entity's role in the digital identity ecosystem

Use Cases

  • Partnership Discovery: Find all projects an entity is involved with
  • Funding Analysis: Track which projects receive funding from specific entities
  • Network Mapping: Understand an entity's position in the ecosystem
  • Due Diligence: Research organizations and their involvement in digital identity
  • Consortium Analysis: Discover consortium memberships and relationships