{"openapi":"3.1.0","info":{"title":"FIDES Organization Catalog API","version":"1.1.0","description":"Public API for querying organizations in the FIDES ecosystem and their roles across wallets, issuers, credentials, and relying parties."},"servers":[{"url":"/api/public"}],"paths":{"/organization":{"get":{"summary":"List organizations","operationId":"listOrganizations","parameters":[{"name":"search","in":"query","schema":{"type":"string"},"description":"Search by name, legal name, description, identifiers, certification codes, or qualified trust-service codes/names (e.g. QEAA)"},{"name":"country","in":"query","schema":{"type":"string"},"description":"Filter by ISO 3166-1 alpha-2 country code"},{"name":"role","in":"query","schema":{"type":"string","enum":["issuer","credential","wallet","rp","personal_wallet_provider","business_wallet_provider","vc_type_authority","relying_party","idv_provider","kyb_provider","system_integrator","consultancy","software_vendor","business_registry","industry_association","standards_development_organization","conformity_scheme_owner","national_accreditation_body","certification_body","conformity_assessment_body"]},"description":"Filter by ecosystem role (legacy aliases issuer, credential, wallet, rp still supported)"},{"name":"certification","in":"query","schema":{"type":"array","items":{"type":"string","enum":["iso27001","iso27701","qtsp","soc2","diacc"]}},"description":"Filter by certification code. Repeat this parameter to match any selected certification (OR semantics)."},{"name":"trustService","in":"query","schema":{"type":"array","items":{"type":"string"}},"description":"Filter by qualified trust-service code carried by a certification, e.g. QEAA (Qualified Electronic Attestation of Attributes) or Q_WAC. Case-insensitive; repeat to match any (OR semantics)."},{"name":"sector","in":"query","schema":{"type":"string","enum":["public_sector","finance","trade","supply_chain","manufacturing","energy","agriculture","food","retail","healthcare","education","construction","mobility","digital"]},"description":"Filter by sector code (organization must include this sector)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["name","country","updatedAt"],"default":"name"}},{"name":"direction","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"size","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Paginated list of organizations","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/Organization"}},"totalElements":{"type":"integer"},"totalPages":{"type":"integer"},"number":{"type":"integer"},"size":{"type":"integer"}}}}}}}}},"/organization/{id}":{"get":{"summary":"Get organization by id","operationId":"getOrganizationById","parameters":[{"name":"id","in":"path","required":true,"description":"Organization catalog id (URL-encoded when needed, e.g. org%3Aanimo)","schema":{"type":"string"}}],"responses":{"200":{"description":"Organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}}},"components":{"schemas":{"OrganizationIdentifiers":{"type":"object","description":"Optional identifiers; only present keys are returned.","properties":{"business_registration_number":{"type":"string"},"vat_number":{"type":"string"},"lei":{"type":"string"},"eori":{"type":"string"},"euid":{"type":"string"},"duns":{"type":"string"},"gln":{"type":"string"},"did":{"type":"string"}}},"CertificationEvidence":{"oneOf":[{"type":"object","required":["kind","url"],"properties":{"kind":{"const":"url"},"url":{"type":"string","format":"uri"},"label":{"type":"string"}}},{"type":"object","required":["kind","format","credentialUri"],"properties":{"kind":{"const":"verifiable_credential"},"format":{"type":"string","enum":["jwt_vc","sd_jwt_vc","ldp_vc","other"]},"credentialUri":{"type":"string","format":"uri"},"notes":{"type":"string"}}}]},"OrganizationCertification":{"type":"object","required":["code"],"properties":{"code":{"type":"string","enum":["iso27001","iso27701","qtsp","soc2","diacc"]},"evidence":{"$ref":"#/components/schemas/CertificationEvidence"},"details":{"type":"object","properties":{"trustServices":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Qualified trust-service code, e.g. QEAA, Q_WAC, Q_CERT_ESIG"},"name":{"type":"string"}}},"description":"Qualified trust services this QTSP may provide (from the EU eIDAS Trust List)."}}}}},"OrganizationSectorCode":{"type":"string","enum":["public_sector","finance","trade","supply_chain","manufacturing","energy","agriculture","food","retail","healthcare","education","construction","mobility","digital"]},"OrganizationEcosystemRoleCode":{"type":"string","enum":["personal_wallet_provider","business_wallet_provider","vc_type_authority","issuer","relying_party","idv_provider","kyb_provider","system_integrator","consultancy","software_vendor","business_registry","industry_association","standards_development_organization","conformity_scheme_owner","national_accreditation_body","certification_body","conformity_assessment_body"]},"Organization":{"type":"object","required":["id","name","sectors"],"properties":{"id":{"type":"string","example":"org:animo"},"name":{"type":"string"},"sectors":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OrganizationSectorCode"}},"legalName":{"type":"string"},"description":{"type":"string"},"identifiers":{"$ref":"#/components/schemas/OrganizationIdentifiers"},"website":{"type":"string","format":"uri"},"logoUri":{"type":"string","format":"uri"},"country":{"type":"string"},"certifications":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationCertification"}},"tags":{"type":"array","items":{"type":"string"}},"offerings":{"type":"array","items":{"type":"string"},"description":"Pro-only services searchable in the Trust Explorer."},"catalogTier":{"type":"string","enum":["Community","Pro"],"description":"Community (free) or Pro plan. Pro-only fields are omitted for Community."},"ecosystemRoles":{"type":"object","properties":{"issuers":{"type":"array","items":{"$ref":"#/components/schemas/EcosystemRef"}},"credentialTypes":{"type":"array","items":{"$ref":"#/components/schemas/EcosystemRef"}},"personalWallets":{"type":"array","items":{"$ref":"#/components/schemas/EcosystemRef"}},"businessWallets":{"type":"array","items":{"$ref":"#/components/schemas/EcosystemRef"}},"relyingParties":{"type":"array","items":{"$ref":"#/components/schemas/EcosystemRef"}}}},"declaredEcosystemRoleCodes":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationEcosystemRoleCode"},"description":"Self-declared roles from community-catalog JSON."},"ecosystemRoleCodes":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationEcosystemRoleCode"},"description":"Declared plus cross-catalog derived roles (deduped)."},"updatedAt":{"type":"string","format":"date-time"}}},"EcosystemRef":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"}}}}}}