{"openapi":"3.0.0","info":{"version":"1.0.0","title":"CAPAdata API","description":"Programmatic access to the UK's most comprehensive DC pension performance dataset. Returns provider, fund, and fund bracket data including performance metrics, asset allocation, ESG disclosures, and retirement functionality.\n\nAuthentication: include your API key in the x-api-key header. To generate an API key go to https://www.capadata.co.uk/account\n\nRate limit: 100 requests per minute per API key.\n\nFull documentation: https://www.capadata.co.uk/resources/api/getting-started"},"servers":[{"url":"https://www.capadata.co.uk/api"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"CapaFundBracket":{"type":"object","properties":{"fundValueData":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number"}},"required":["time","value"]},"description":"Shows how the value of the fund has changed over time."},"annualisedRisk":{"type":"object","properties":{"1":{"type":"number","nullable":true},"3":{"type":"number","nullable":true},"5":{"type":"number","nullable":true}},"description":"How much the fund value has varied in number of years (higher = more volatile)."},"fundBracketTime":{"type":"string","enum":["30 Years","5 Years","1 Day"],"description":"Which time period this data relates to (e.g. 5 Years, 30 Years)."},"topBottomPriceVariance":{"type":"array","items":{"type":"object","properties":{"year":{"type":"string"},"value":{"type":"number","nullable":true}},"required":["year","value"]},"description":"Difference between the best and worst performing years."}},"required":["fundValueData","annualisedRisk","fundBracketTime","topBottomPriceVariance"]},"CapaFund":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","description":"Full name of the fund."},"shortName":{"type":"string","nullable":true,"description":"Abbreviated name for the fund."},"isCapaConstituent":{"type":"boolean","description":"Is this fund included in the CAPA comparison set?"},"color":{"type":"string","description":"A colour used to identify this fund visually."},"fundBrackets":{"type":"array","items":{"$ref":"#/components/schemas/CapaFundBracket"}}},"required":["id","name","shortName","isCapaConstituent","color","fundBrackets"],"description":"The CAPA average fund - a composite benchmark calculated from the mean quarterly percentage returns of all CAPA constituent funds, indexed to a base value of 100. Uses a reduced version of the Fund structure because several per-fund fields (assetAllocationData, sharpeRatio, tcfdWaci, fundExcludes) are not meaningful for a synthetic benchmark."},"InflationPoint":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number"}},"required":["time","value"]},"InflationSeries":{"type":"object","properties":{"boeBaseRate":{"type":"array","items":{"$ref":"#/components/schemas/InflationPoint"},"description":"UK Bank of England base rate, expressed as a quarterly index series suitable for overlaying on fund performance charts."},"cpi":{"type":"array","items":{"$ref":"#/components/schemas/InflationPoint"},"description":"UK Consumer Prices Index, expressed as a quarterly index series suitable for overlaying on fund performance charts."}},"required":["boeBaseRate","cpi"],"description":"Quarterly economic reference series (Bank of England base rate and UK CPI) suitable for overlaying on fund performance charts."},"FundBracket":{"type":"object","properties":{"assetAllocationData":{"type":"object","properties":{"UK Equities":{"type":"number","nullable":true},"Overseas Equities":{"type":"number","nullable":true},"US Equities":{"type":"number","nullable":true},"Other Developed Markets Equities (exc. UK & US)":{"type":"number","nullable":true},"Emerging Markets Equities":{"type":"number","nullable":true},"Listed Private Equity (inc. VC)":{"type":"number","nullable":true},"Unlisted Private Equity (inc. VC)":{"type":"number","nullable":true},"All Government Bonds":{"type":"number","nullable":true},"UK Government Bonds (Gilts)":{"type":"number","nullable":true},"Overseas Government Bonds":{"type":"number","nullable":true},"All Corporate Bonds":{"type":"number","nullable":true},"UK Corporate Bonds":{"type":"number","nullable":true},"Overseas Corporate Bonds":{"type":"number","nullable":true},"High Yield Bonds":{"type":"number","nullable":true},"Emerging Market Debt":{"type":"number","nullable":true},"Index-Linked Bonds":{"type":"number","nullable":true},"Listed Private Credit":{"type":"number","nullable":true},"Unlisted Private Credit":{"type":"number","nullable":true},"Property/Real Estate (Direct)":{"type":"number","nullable":true},"Commodities":{"type":"number","nullable":true},"Natural Resources":{"type":"number","nullable":true},"Listed Property":{"type":"number","nullable":true},"Unlisted Property":{"type":"number","nullable":true},"Listed Infrastructure":{"type":"number","nullable":true},"Unlisted Infrastructure":{"type":"number","nullable":true},"Hedge Funds/Absolute Return":{"type":"number","nullable":true},"Multi-Asset Credit":{"type":"number","nullable":true},"Structured Products":{"type":"number","nullable":true},"Cash/Money Market":{"type":"number","nullable":true},"Short-term Deposits":{"type":"number","nullable":true},"LDI (Liability Driven Investment)":{"type":"number","nullable":true},"Insurance-linked Securities":{"type":"number","nullable":true},"Derivatives/Overlays":{"type":"number","nullable":true},"Other":{"type":"number","nullable":true}},"description":"Breakdown of what the fund invests in (e.g. % in bonds, equities, property, etc.)."},"fundValueData":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number"}},"required":["time","value"]},"description":"Shows how the value of the fund has changed over time."},"sharpeRatio":{"type":"object","properties":{"1":{"type":"number","nullable":true},"3":{"type":"number","nullable":true},"5":{"type":"number","nullable":true}},"description":"A measure of performance adjusted for risk over number of years."},"annualisedRisk":{"type":"object","properties":{"1":{"type":"number","nullable":true},"3":{"type":"number","nullable":true},"5":{"type":"number","nullable":true}},"description":"How much the fund value has varied in number of years (higher = more volatile)."},"fundBracketTime":{"type":"string","enum":["30 Years","5 Years","1 Day"],"description":"Which time period this data relates to (e.g. 5 Years, 30 Years)."},"topBottomPriceVariance":{"type":"array","items":{"type":"object","properties":{"year":{"type":"string"},"value":{"type":"number","nullable":true}},"required":["year","value"]},"description":"Difference between the best and worst performing years."}},"required":["assetAllocationData","fundValueData","sharpeRatio","annualisedRisk","fundBracketTime","topBottomPriceVariance"]},"Fund":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","description":"Full name of the fund."},"shortName":{"type":"string","nullable":true,"description":"Abbreviated name for the fund."},"isCapaConstituent":{"type":"boolean","description":"Is this fund included in the CAPA comparison set?"},"color":{"type":"string","description":"A colour used to identify this fund visually."},"fundBrackets":{"type":"array","items":{"$ref":"#/components/schemas/FundBracket"}},"tcfdWaci":{"type":"number","nullable":true,"description":"Weighted Average Carbon Intensity – a climate metric."},"fundExcludes":{"type":"object","properties":{"alcohol":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"tobacco":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"gambling":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"pornography":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"fossilFuels":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"thermalCoalAndTarSands":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"nuclearIndustry":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"armaments":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"controversialWeapons":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"animalTesting":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"furTrade":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]},"globalCompactViolators":{"type":"string","nullable":true,"enum":["YES","NO","PARTIAL"]}},"description":"Shows what the fund avoids investing in (e.g. alcohol, weapons, fossil fuels). Can be YES / NO / PARTIAL for each category."}},"required":["id","name","shortName","isCapaConstituent","color","fundBrackets","tcfdWaci","fundExcludes"]},"Provider":{"type":"object","properties":{"name":{"type":"string","minLength":3,"description":"The full name of the provider (e.g. Aviva)."},"shortName":{"type":"string","nullable":true,"description":"A shorter or internal name for the provider (optional)."},"imageUrl":{"type":"string","description":"A link to an image/logo for the provider.","example":"https://www.capadata.co.uk/image.png"},"slug":{"type":"string","minLength":3,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"A URL-friendly name (e.g. “aviva” or “standard-life”). Lowercase, with dashes instead of spaces.","example":"provider-1"},"description":{"type":"string","description":"A short summary of the provider. You can describe what kind of pension schemes they offer, or any key characteristics."},"funds":{"type":"array","items":{"$ref":"#/components/schemas/Fund"},"description":"A list of the provider’s pension funds."},"activeDcMembersDataPoints":{"type":"object","additionalProperties":{"type":"number","nullable":true},"description":"How many active members are in defined contribution schemes over time."},"deferredDcMembersDataPoints":{"type":"object","additionalProperties":{"type":"number","nullable":true},"description":"How many deferred (no longer contributing) members there are over time."},"bundledDcAssetsDataPoints":{"type":"object","additionalProperties":{"type":"number","nullable":true},"description":"Total value of bundled defined contribution assets over time."},"employersAcrossDcBusinessDataPoints":{"type":"object","additionalProperties":{"type":"number","nullable":true},"description":"Number of employers involved in this provider’s DC business."},"bulkTransfersValueDataPoints":{"type":"object","additionalProperties":{"type":"number","nullable":true},"description":"Value of money moved in or out via bulk transfers."},"bulkTransfersNumberDataPoints":{"type":"object","additionalProperties":{"type":"number","nullable":true},"description":"Number of bulk transfers made."},"authorisedInPrivateMarket":{"type":"boolean","nullable":true,"description":"Is this provider authorised to invest in private markets?"},"technologyPlatformUsed":{"type":"string","nullable":true,"description":"Name of the technology platform the provider uses."},"facilitatesAdviserCharging":{"type":"string","nullable":true,"description":"Does this provider support adviser charging?"},"facilitatesPensionsAdviceAllowance":{"type":"string","nullable":true,"description":"Does this provider allow use of pensions advice allowance?"},"appForAllMembers":{"type":"boolean","nullable":true,"description":"Does the provider offer a mobile app for all members?"},"percentageMembersDownloadedApp":{"type":"number","nullable":true,"description":"What percentage of members have downloaded the app?"},"percentageMembersViewedAppLastYear":{"type":"number","nullable":true,"description":"What percentage used the app in the last year?"},"percentageMembersNominatedDeathBenefitBeneficiary":{"type":"number","nullable":true,"description":"What percentage of members have nominated a beneficiary?"},"pensionStructuresOfferedReliefAtSource":{"type":"boolean","nullable":true,"description":"Does the provider support “Relief at Source”?"},"pensionStructuresOfferedNetPay":{"type":"boolean","nullable":true,"description":"Does the provider support “Net Pay”?"},"offersPartialWithdrawalFromAge55":{"type":"boolean","nullable":true,"description":"Can members make partial withdrawals from age 55?"},"offersFlexiAccessDrawdown":{"type":"boolean","nullable":true,"description":"Does the provider support flexible drawdown?"},"offersUfpls":{"type":"boolean","nullable":true,"description":"Does the provider offer UFPLS (Uncrystallised Fund Pension Lump Sum)?"},"offersPartialUfpls":{"type":"boolean","nullable":true,"description":"Does the provider offer *partial* UFPLS?"},"offersDripFeedDrawdown":{"type":"boolean","nullable":true,"description":"Does it offer drip-feed drawdown?"},"dripFeedDrawdownAccommodatesProtectedLifetimeAllowances":{"type":"boolean","nullable":true,"description":"Can protected lifetime allowances be used with drip-feed drawdown?"},"offersMultiGoalOrMultiWrapperBucketing":{"type":"boolean","nullable":true,"description":"Does the provider support multiple goals or wrapper bucketing?"},"offersAnnuityBorkingService":{"type":"string","nullable":true,"description":"Does the provider offer a service for buying annuities?"},"tcfdReportLink":{"type":"string","nullable":true,"format":"uri","description":"Link to the provider’s TCFD climate report (if available)."},"tcfdCarbonFootprint":{"type":"string","nullable":true,"description":"Total carbon footprint reported in the TCFD report."},"tcfdOtherDecarbonisationMetrics":{"type":"string","nullable":true,"description":"Any other metrics reported in the TCFD submission."},"netZeroTargetYear":{"type":"number","nullable":true,"description":"The year by which the provider targets net zero."},"interimNetZeroTarget":{"type":"string","nullable":true,"description":"Any shorter-term net zero milestones (e.g. 50% by 2030)."},"id":{"type":"string"},"createdAt":{"type":"string"}},"required":["name","shortName","imageUrl","slug","description","funds","activeDcMembersDataPoints","deferredDcMembersDataPoints","bundledDcAssetsDataPoints","employersAcrossDcBusinessDataPoints","bulkTransfersValueDataPoints","bulkTransfersNumberDataPoints","authorisedInPrivateMarket","technologyPlatformUsed","facilitatesAdviserCharging","facilitatesPensionsAdviceAllowance","appForAllMembers","percentageMembersDownloadedApp","percentageMembersViewedAppLastYear","percentageMembersNominatedDeathBenefitBeneficiary","pensionStructuresOfferedReliefAtSource","pensionStructuresOfferedNetPay","offersPartialWithdrawalFromAge55","offersFlexiAccessDrawdown","offersUfpls","offersPartialUfpls","offersDripFeedDrawdown","dripFeedDrawdownAccommodatesProtectedLifetimeAllowances","offersMultiGoalOrMultiWrapperBucketing","offersAnnuityBorkingService","tcfdReportLink","tcfdCarbonFootprint","tcfdOtherDecarbonisationMetrics","netZeroTargetYear","interimNetZeroTarget","id","createdAt"]}},"parameters":{}},"paths":{"/v1/providers":{"get":{"summary":"List providers","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Provider data list","content":{"application/json":{"schema":{"type":"object","properties":{"dataLastUpdated":{"type":"string","description":"ISO 8601 timestamp of when the provider data was last updated (reflects the most recent data upload, including corrective updates)","example":"2026-03-19T13:38:37.000Z"},"latestQuarter":{"type":"string","description":"The latest quarter covered by the data (e.g. \"Q4 2025\")","example":"Q4 2025"},"capaFund":{"$ref":"#/components/schemas/CapaFund"},"inflationSeries":{"$ref":"#/components/schemas/InflationSeries"},"providers":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}},"required":["dataLastUpdated","latestQuarter","capaFund","inflationSeries","providers"]}}}},"401":{"description":"Missing or invalid API key"},"403":{"description":"Valid API key but insufficient subscription tier"},"429":{"description":"Rate limit exceeded (100 requests per minute per API key). Check Retry-After header."}}}}}}