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
Related Endpoints
- GET /entities - List all entities
- GET /projects - Find projects related to entities
- GET /people/{id} - Get details about people representing entities