API Documentation

List Industries

GET /api/v1/industries

Get industries with significant project associations (5+ approved relations). Shows which industry sectors are being targeted by decentralized identity projects.

Request

Query Parameters

Parameter Type Required Default Description
include_projects boolean No false If true, includes list of projects targeting each industry

Example Requests

bash
# Get all industries with project counts
curl -X GET "https://www.weboftrust.org/api/v1/industries" \
  -H "X-API-Key: YOUR_API_KEY"

# Get industries with their associated projects
curl -X GET "https://www.weboftrust.org/api/v1/industries?include_projects=true" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Schema

typescript
interface IndustryListResponse {
  data: Industry[];
}

interface Industry {
  id: number;
  name: string;
  project_count: number;    // Number of approved project relations
  projects?: ProjectIndustry[];  // Only included when include_projects=true
}

interface ProjectIndustry {
  id: number;
  title: string;
  type: "DID Project" | "Consortium";
  status?: string;
  source?: string;     // URL confirming the project targets this industry
  excerpt?: string;    // Text snippet from source explaining the connection
}

Example Response (without projects)

json
{
  "data": [
    {
      "id": 200,
      "name": "Agriculture",
      "project_count": 12
    },
    {
      "id": 666,
      "name": "Banking",
      "project_count": 28
    },
    {
      "id": 731,
      "name": "Healthcare",
      "project_count": 45
    },
    {
      "id": 734,
      "name": "International Trade",
      "project_count": 18
    },
    {
      "id": 736,
      "name": "Supply Chain",
      "project_count": 32
    }
  ]
}

Example Response (with projects)

json
{
  "data": [
    {
      "id": 200,
      "name": "Agriculture",
      "project_count": 12,
      "projects": [
        {
          "id": 160,
          "title": "3air Platform",
          "type": "DID Project",
          "status": "Launched",
          "source": "https://3air.io/blog/3air-use-cases/",
          "excerpt": "3air's blockchain platform enables farmers to track their produce from farm to table, ensuring transparency in agricultural supply chains."
        },
        {
          "id": 38,
          "title": "AGROS",
          "type": "DID Project",
          "status": "Launched",
          "source": "https://agros.tech/farmers",
          "excerpt": "AGROS provides digital identity solutions for farmers, enabling them to access credit and insurance services based on their verified agricultural history."
        },
        {
          "id": 9,
          "title": "Alastria ID",
          "type": "DID Project",
          "status": "Launched",
          "source": "https://alastria.io/en/cases",
          "excerpt": "Alastria's use cases include agricultural traceability, where farmers and cooperatives can certify the origin and quality of their products."
        }
      ]
    },
    {
      "id": 666,
      "name": "Banking",
      "project_count": 28,
      "projects": [
        {
          "id": 123,
          "title": "Digital Identity Banking Solution",
          "type": "DID Project",
          "status": "Launched",
          "source": "https://example-bank.com/digital-identity",
          "excerpt": "Our banking platform integrates decentralized identity verification to reduce KYC costs by 60% while improving customer onboarding experience."
        }
      ]
    }
  ]
}

Error Responses

500 Internal Server Error

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

Inclusion Criteria

Industries are included when they have:

  • At least 5 approved project relationships
  • Verified sources confirming the industry targeting
  • Clear use cases for digital identity

Use Cases

  • Market Analysis: Identify which industries are adopting DID
  • Investment Research: Find sectors with high DID activity
  • Partnership Discovery: Connect with projects in your industry
  • Trend Analysis: Track industry adoption over time
  • Use Case Development: Learn from existing implementations

Data Quality

  • All project-industry relationships are manually verified
  • Sources are archived when possible
  • Excerpts provide context for the relationship
  • Regular updates ensure current information

Performance Considerations

  • Base response is lightweight (industry list only)
  • Setting include_projects=true significantly increases response size
  • Results are cached for performance
  • Consider filtering by specific industries in your application