{"openapi":"3.1.0","info":{"title":"Credential Catalog API","description":"API to search credential definitions in the FIDES Credential Catalog. Returns credential types (schema, format, kind) only. Issuer-related fields (issuance URL, configuration ID, etc.) are omitted; for issuance and issuer details, use the Issuer Catalog API.","contact":{"name":"Fides Credential Catalog","email":"catalog@fides.community","url":"https://fides-credential-catalog.vercel.app"},"version":"2.3"},"tags":[{"name":"Search API","description":"Search in the catalog"}],"paths":{"/api/public/credentialtype/{id}":{"get":{"tags":["Search API"],"summary":"Get one credential type by catalog id","operationId":"getById","parameters":[{"name":"id","in":"path","required":true,"description":"Catalog credential id (URL-encoded when it contains reserved characters, e.g. cred:…)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialTypeDto"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}}}},"/api/public/credentialtype":{"get":{"tags":["Search API"],"summary":"Find all credential types based on the query parameters","operationId":"find","parameters":[{"name":"credentialKind","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PERSONAL","ORGANIZATIONAL","PRODUCT","UNKNOWN"]}}},{"name":"vcFormat","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"sector","in":"query","required":false,"description":"Filter by sector code (same taxonomy as the organization catalog). Repeat for OR semantics: credential matches if it has any selected sector.","schema":{"type":"array","items":{"type":"string","enum":["public_sector","finance","trade","supply_chain","manufacturing","energy","agriculture","food","retail","healthcare","education","construction","mobility","digital"]}}},{"name":"ecosystem","in":"query","required":false,"description":"Filter by ecosystem code. Repeat for OR semantics.","schema":{"type":"array","items":{"type":"string","enum":["eudi_wallet","uncefact","gaia_x","open_badges","iso_mdl","india_stack","swiyu"]}}},{"name":"theme","in":"query","required":false,"description":"Filter by use-case theme code. Repeat for OR semantics: credential matches if it has any selected theme.","schema":{"type":"array","items":{"type":"string","enum":["person_identity","organizational_identity","payments","compliance_reporting","trade_documents","education","digital_product_passports","dataspaces","agentic_ai"]}}},{"name":"page","in":"query","description":"Zero-based page index (0..N)","required":false,"schema":{"type":"integer","default":0,"minimum":0}},{"name":"size","in":"query","description":"The size of the page to be returned","required":false,"schema":{"type":"integer","default":200,"minimum":1}},{"name":"sort","in":"query","description":"Sorting criteria in the format: property,(asc|desc). Multiple sort criteria are supported.","required":false,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedModelCredentialTypeDto"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}}}}},"components":{"schemas":{"CredentialTypeDto":{"type":"object","description":"Credential definition only. Issuer-related fields (issuanceUrl, credentialConfigurationId, deploymentEnvironment, etc.) are omitted; use the Issuer Catalog API for those.","properties":{"id":{"type":"string","description":"Catalog credential ID (e.g. cred:authority:key:format)"},"credentialKind":{"type":"string","enum":["PERSONAL","ORGANIZATIONAL","PRODUCT","UNKNOWN"],"description":"Mapped from subjectType"},"vcFormat":{"type":"string","description":"VC format code: sd_jwt_vc, mdoc, jwt_vc, vcdm_1_1, vcdm_2_0, anoncreds, idemix, apple_wallet_pass, google_wallet_pass, acdc"},"schemaUrl":{"type":"string","format":"uri"},"schemaInfo":{"type":"string","description":"Short description"},"trustFrameworkUrl":{"type":"string","format":"uri","description":"Rulebook URL when present"},"sectors":{"type":"array","items":{"type":"string","enum":["public_sector","finance","trade","supply_chain","manufacturing","energy","agriculture","food","retail","healthcare","education","construction","mobility","digital"]},"description":"Sector codes (aligned with FIDES organization catalog)"},"ecosystems":{"type":"array","items":{"type":"string","enum":["eudi_wallet","uncefact","gaia_x","open_badges","iso_mdl","india_stack","swiyu"]}},"themes":{"type":"array","items":{"type":"string","enum":["person_identity","organizational_identity","payments","compliance_reporting","trade_documents","education","digital_product_passports","dataspaces","agentic_ai"]},"description":"Optional use-case themes (empty array when not set in catalog)"}}},"PageMetadata":{"type":"object","properties":{"size":{"type":"integer"},"number":{"type":"integer"},"totalElements":{"type":"integer"},"totalPages":{"type":"integer"}}},"PagedModelCredentialTypeDto":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/CredentialTypeDto"}},"page":{"$ref":"#/components/schemas/PageMetadata"}}},"ErrorMessage":{"type":"object","properties":{"message":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}}},"servers":[{"url":"https://fides-credential-catalog.vercel.app","description":"This deployment"}]}