1. SupplierIQ
IBISWorld API
  • Overview
    • πŸš€ Getting Started
    • πŸ“Š About IBISWorld
    • 🚦Rate Limits & Data Size
    • 🌐 API Uptime, SLA & Support
    • πŸ“Œ Versioning & API Changes
    • ❓Frequently Asked Questions (FAQs)
    • πŸ“° API Release Notes
    • Authentication
      POST
  • How-To Guides
    • πŸ” How To: Convert ANZSIC ➜ IBISWorld Report
    • πŸ“₯ How To: Download an IBISWorld PDF Report
  • Industry
    • Risk
      • Risk Reports List
      • Recently Updated Risk Reports List
      • Full Industry Risk Report
      • Sections of Risk Report
      • Early Warning System (EWS)
    • States (US) & Provinces (Canada)
      • Industry Reports List
      • Full Industry Report
      • Sections of Industry Report
    • Segment Benchmarking (US)
      • Full Segment Benchmarking Report
      • Sections of a Segment Benchmarking Report
    • ESG
      • Full ESG Report
      • Sections of ESG Report
    • Industry Reports List
    • Recently Updated Industry Reports List
    • Sections of Industry Report
    • Full Industry Report
    • One Section from Multiple Industry Reports
    • Industry Report Images
  • Classifications
    • List of Classification System Versions
    • List of Classification System Titles and Codes
    • Classification System to IBISWorld Report Concordance
    • IBISWorld Report to Classification System Concordance
  • Downloads
    • Download a Report
  • Business Environment Profiles
    • BED Reports List
    • Recently Updated BED Reports List
    • Full BED Report
    • Sections of BED Report
  • Occupation Profiles
    • Occupation Report List
    • Recently Updated Occupation Report List
    • Full Occupation Report
    • Sections of Occupation Report
  • Company
    • Company Reports List (Australia)
    • Recently Updated Company Reports List
    • Full Company Report (Australia)
    • Sections of Company Report (Australia)
  • Procurement
    • Procurement Reports
    • Recently Updated Procurement Reports List
    • Sections of Procurement Report
    • One Section from Multiple Procurement Reports
  • SupplierIQ
    • SupplierIQ Report List
      POST
    • Recently Updated SupplierIQ Reports List
      POST
    • Sections of SupplierIQ Report
      POST
  • Schemas
    • classification_system_version
    • ibis_report_concordance
    • ibis_industry_report
    • ibis_industry_risk_report
    • ibis_bed_report
    • ibis_company_report
  1. SupplierIQ

Sections of SupplierIQ Report

POST
/supplieriq/v3/sections
Returns one or more sections of a SupplierIQ company report in a single request.
Bundle the sections you need into the ReportSections array to reduce API calls and improve performance. Only sections you request appear in the response Body β€” unrequested sections are not returned as null keys.
The response shape for financial sections (incomestatement, balancesheet, cashflows, ratios) differs between public and private companies. Use the OwnershipType field in GeneralInformation to drive any conditional handling β€” see Public vs Private Companies below.

Request Parameters#

ParameterTypeRequiredDefaultDescription
CountrystringYesβ€”IBISWorld country code. SupplierIQ is US-only β€” value must be "US".
CodeintegerYesβ€”Unique company identifier. Obtained from /supplieriq/v3/reportlist.
LanguagestringNoβ€”Report language (e.g., "English").
ReportSectionsarray (string)Yesβ€”One or more section parameter names. See the Available Sections Reference Table below.
AllYearsbooleanNofalseControls time-series depth for public-company financial sections. false = most recent year only. true = full available history (up to 9 years). Has no effect on private-company financials.

Available Sections Reference Table#

Company Snapshot
Section NameParams to include in ReportSections arrayDescription
General InformationgeneralinformationHeadline company metadata: ownership type, headline revenue, trend, financial strength, employees, life cycle, registered/trading name, chief executive, headquarters address & phone, website, ticker, primary and secondary NAICS, and narrative description.
Product & Service MarketsproductservicemarketsArray of markets the company participates in, with banded market share, share trend, market concentration, market profitability, profit trend, and average vendor risk.
Financial Insights
Section NameParams to include in ReportSections arrayDescription
Income StatementincomestatementIncome statement line items (Revenue, Cost of Revenue, Gross Profit, EBIT, EBITDA, Net Income, etc.) as time-series metric objects.
Balance SheetbalancesheetBalance sheet line items grouped into CurrentAssets, NoncurrentAssets, CurrentLiabilities, NoncurrentLiabilities, and Equity.
Cash FlowscashflowsCash flow line items grouped into OperatingActivities, InvestingActivities, FinancingActivities, and SupplementalData.
RatiosratiosFinancial ratios (Current Ratio, Debt Ratio, EBIT, EBITDA, Gross Margin, Operating Margin, Quick Ratio, Return on Assets, Return on Equity, etc.). Public companies only β€” returns null for private companies.

Public vs Private Companies#

SupplierIQ covers both public and private US companies. They share an identical envelope and metric structure but differ in the values returned in each Years entry.
DimensionPublic companiesPrivate companies
Source valuesActual reported financialsIBISWorld-estimated ranges
Year coverageUp to 9 years of history (controlled by AllYears)Single estimated period
Per-year payloadYear, ValueYear, RangeLow, RangeHigh, Confidence
IsEstimated flagfalsetrue
Ratios sectionPopulatedReturns null
Ticker, RevenueVolatilityPopulatednull
Note: All financial line items in the SupplierIQ taxonomy are always present in the response β€” they are never omitted. When data is unavailable for a public-company year, Value is null. When a line item is not applicable for a private company, RangeLow and RangeHigh are both 0.0 β€” this signals "not applicable", not "zero".

Section Field Definitions#

GeneralInformation
FieldTypeDescription
OwnershipTypestringEnum: "Public", "Private". Determines the financial-section response shape.
RevenuefloatHeadline revenue figure. Actual for public companies; IBISWorld-estimated for private.
RevenueYearintegerThe year the headline revenue figure refers to.
RevenueIsEstimatedbooleanfalse for public companies; true for private.
RevenueTrendstringEnum: "Increasing", "Steady", "Decreasing".
FinancialStrengthstringEnum: "Strong", "Moderate", "Weak".
RevenueVolatilitystring | nullEnum: "High", "Moderate", "Low". null for private companies.
EmployeesintegerTotal headcount.
LifeCyclestringEnum: "Startup", "Growth", "Established", "Mature", "Declining".
RegisteredNamestringOfficial registered company name.
TradingNamestringTrading or brand name.
ChiefExecutivestringName of the current chief executive officer.
HeadquartersAddressstringFull headquarters address.
HeadquartersPhonestringHeadquarters telephone number.
WebsitestringCompany website URL.
Tickerstring | nullStock ticker symbol. null for private companies.
PrimaryNAICSobjectPrimary NAICS classification β€” Code (string) and Description (string).
SecondaryNAICSarrayArray of secondary NAICS classifications, each with Code and Description.
DescriptionstringNarrative company description.

ProductServiceMarkets (per array entry)
FieldTypeDescription
MarketNamestringName of the market the company participates in.
NAICSstringNAICS code for the market.
MarketSharestringCompany market share as a banded string (e.g., "<5", "5-10", "10-15", "15-20", "20-25", "25+"). Never a float β€” do not attempt numeric parsing.
MarketShareTrendstringEnum: "Increasing", "Steady", "Decreasing".
MarketShareConcentrationstringEnum: "Low", "Medium", "High".
MarketProfitabilitystringEnum: "Low", "Medium", "High".
ProfitTrendstringEnum: "Stable", "Rising", "Falling".
AvgVendorRiskstringEnum: "Low", "Medium", "High".

Financial Sections β€” IncomeStatement, BalanceSheet, CashFlows
All three financial sections share a common item shape inspired by the IBISWorld industry KeyStatistics pattern.
FieldTypeDescription
IsEstimatedbooleanfalse for public companies; true for private.
ItemsarrayArray of financial line item metric objects. Present directly under IncomeStatement; nested under sub-group objects for BalanceSheet and CashFlows.
BalanceSheet sub-groups: CurrentAssets, NoncurrentAssets, CurrentLiabilities, NoncurrentLiabilities, Equity β€” each carrying its own Items array.
CashFlows sub-groups: OperatingActivities, InvestingActivities, FinancingActivities, SupplementalData β€” each carrying its own Items array.

Notes#

The response shape is identical regardless of AllYears β€” only the number of entries in each Years array changes.
Only sections listed in ReportSections appear in the response Body. Unrequested sections are not returned as null keys.
All financial line items in the taxonomy are always present in an Items array even when the underlying value is null (public) or RangeLow/RangeHigh is 0.0 (private, not applicable).
For private companies, AllYears is silently ignored β€” a single estimated period is always returned.

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Body Params application/jsonRequired

Example
{
    "Code": "405819",
    "Country": "US",
    "Language": "English",
    "ReportSections": [
        "title",
        "publicationdate",
        "generalinformation",
        "productservicemarkets",
        "incomestatement",
        "balancesheet",
        "cashflows",
        "ratios"
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.ibisworld.com/supplieriq/v3/sections' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Code": "405819",
    "Country": "US",
    "Language": "English",
    "ReportSections": [
        "title",
        "publicationdate",
        "generalinformation",
        "productservicemarkets",
        "incomestatement",
        "balancesheet",
        "cashflows",
        "ratios"
    ]
}'

Responses

🟒200Forbidden
application/json
Bodyapplication/json

Examples
{
    "Sections": [
        {
            "RequestedSection": "Title",
            "StatusCode": 200,
            "Body": {
                "Title": "B. Braun Medical Inc."
            }
        },
        {
            "RequestedSection": "PublicationDate",
            "StatusCode": 200,
            "Body": {
                "PublicationDate": "2026-06-01T00:00:00"
            }
        },
        {
            "RequestedSection": "GeneralInformation",
            "StatusCode": 200,
            "Body": {
                "OwnershipType": "Private",
                "Revenue": 1700950269,
                "RevenueYear": 2025,
                "RevenueIsEstimated": true,
                "RevenueTrend": "-",
                "FinancialStrength": "Moderate",
                "RevenueVolatility": "-",
                "Employees": 6000,
                "LifeCycle": "",
                "RegisteredName": "B. Braun Medical Inc. ",
                "TradingName": "B. Braun Medical",
                "ChiefExecutive": "Jean-Claude Dubacher ",
                "HeadquartersAddress": null,
                "HeadquartersPhone": "",
                "Website": "https://www.bbraunusa.com",
                "Ticker": null,
                "PrimaryNAICS": {
                    "Code": "33911",
                    "Description": "Medical Equipment and Supplies Manufacturing in the US"
                },
                "SecondaryNAICS": [],
                "Description": "B. Braun Medical Inc. is a private company operating  in the manufacturing and information sectors. The company's offerings include medical tissue closures and telecom expense management software.."
            }
        },
        {
            "RequestedSection": "ProductServiceMarkets",
            "StatusCode": 200,
            "Body": {
                "ProductServiceMarkets": [
                    {
                        "Country": "US",
                        "Code": "339110",
                        "Title": "Medical Tissue Closures",
                        "Language": "English",
                        "ReportType": "Procurement",
                        "PublishedDate": "2026-04-13T00:00:00",
                        "MarketShare": "5-10",
                        "MarketShareTrend": "Increasing",
                        "MarketShareConcentration": "Medium",
                        "MarketProfitability": "High",
                        "ProfitTrend": "Falling",
                        "AvgVendorRisk": "Low"
                    },
                    {
                        "Country": "US",
                        "Code": "513210",
                        "Title": "Telecom Expense Management Software",
                        "Language": "English",
                        "ReportType": "Procurement",
                        "PublishedDate": "2026-04-06T00:00:00",
                        "MarketShare": "10-15",
                        "MarketShareTrend": "Decreasing",
                        "MarketShareConcentration": "Low",
                        "MarketProfitability": "High",
                        "ProfitTrend": "Stable",
                        "AvgVendorRisk": "Low"
                    }
                ]
            }
        },
        {
            "RequestedSection": "IncomeStatement",
            "StatusCode": 200,
            "Body": {
                "IncomeStatement": {
                    "IsEstimated": true,
                    "Groups": [
                        {
                            "Group": "",
                            "Items": [
                                {
                                    "Caption": "Revenue",
                                    "Unit": "$",
                                    "Multiplicator": 1,
                                    "Years": [
                                        {
                                            "Year": 2025,
                                            "RangeLow": 1700950268.7,
                                            "RangeHigh": 2701616397.9,
                                            "Confidence": 72.92
                                        }
                                    ]
                                },
                                {
                                    "Caption": "Cost of Revenue",
                                    "Unit": "$",
                                    "Multiplicator": 1,
                                    "Years": [
                                        {
                                            "Year": 2025,
                                            "RangeLow": 719388521.1,
                                            "RangeHigh": 1253534978.9,
                                            "Confidence": 62.5
                                        }
                                    ]
         
Modified atΒ 2026-06-08 23:01:29
Previous
Recently Updated SupplierIQ Reports List
Next
classification_system_version
Built with