Supergood | Bloomberg Tax API

Supergood | Bloomberg Tax API

Programmatically access Bloomberg Tax entity records, filing calendars and statuses, fixed assets/depreciation, ASC 740 provision outputs, and jurisdictional rate data with a stable REST API. Supergood builds and operates production-grade, unofficial Bloomberg Tax integrations so your team can automate compliance, audit, and reporting workflows without heavy custom engineering.

Plain English: Bloomberg Tax is tax intelligence and compliance software for corporate tax departments and accounting firms. An unofficial API lets you programmatically pull legal entities, tax filings and due dates, indirect tax rates, fixed asset registers with multi-book depreciation, provision results (ETR, current/deferred tax expense), workpapers, and approvals—and push updates like filings, adjustments, and provisioning inputs back into Bloomberg Tax.

For a tech company integrating with Bloomberg Tax, this means you can ingest real-time entity and filing data to power compliance dashboards, sync tax provision journals to your ERP/general ledger (e.g., NetSuite, SAP, Oracle), reconcile fixed assets and depreciation across books, validate transactions against authoritative sales/use tax rates, orchestrate approvals, and keep GRC/audit platforms aligned with tax positions, controls, and evidence. You can also trigger filing reminders, attach documents, capture audit trails, and maintain consistent multi-entity tax calendars across stakeholder systems.

What is Bloomberg Tax?

Bloomberg Tax (https://pro.bloombergtax.com/) is a cloud platform for tax professionals that combines authoritative research, global tax intelligence, and software for tax compliance and accounting workflows. Corporate tax teams and firms use Bloomberg Tax to research evolving tax law, manage legal entities and filing calendars, calculate ASC 740 tax provisions, track fixed assets and multi-book depreciation, monitor indirect tax rates, and produce workpapers and journal outputs—backed by current statutes, regulations, and expert analysis.

Core product areas include:

  • Tax Research & Intelligence (News, Statutes, Regulations, Portfolios, Country Guides)
  • Corporate Tax Provision (ASC 740, ETR, Deferred Tax, Journal Entries)
  • Fixed Assets & Depreciation (Multi-Book, Methods/Conventions, Section 179/Bonus)
  • Indirect Tax Data (Sales & Use Tax Rates, Jurisdictional Rules)
  • Workpapers & Compliance Calendar (Filings, Tasks, Approvals, Evidence)

Common data entities:

  • Firms/Companies, Users, Roles/Permissions
  • Legal Entities and Consolidation Groups (Identifiers, Jurisdictions, Fiscal Calendars)
  • Filings/Returns (Income, Sales/Use, Payroll, Property; Status, Amounts, Due Dates)
  • Fixed Assets (Registers, Books, Methods, Conventions, Depreciation, Disposals)
  • Tax Rates & Jurisdictions (Codes, Effective Dates, Rules)
  • Workpapers, Tasks, Approvals (Artifacts, Status, Audit Trail)
  • Provision Inputs/Outputs (Trial Balance Mappings, Differences, Journals)

The Bloomberg Tax Integration Challenge

Tax teams rely on Bloomberg Tax every day, but turning portal-centric workflows into API-driven automation is non-trivial:

  • Role-aware access: Research content, compliance data, and calculation modules are gated by licensing and entitlements
  • Compliance rigor: Jurisdiction-specific rules, filing calendars, and ASC 740 requirements demand precise modeling and auditability
  • Multi-book complexity: Fixed assets span GAAP, tax, IFRS books with different methods and conventions
  • Authentication complexity: SSO/MFA and session lifecycles complicate headless automation
  • Data spread: Key objects span entities, filings, rates, assets, workpapers, and provisions with cross-module dependencies

How Supergood Creates Bloomberg Tax APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Bloomberg Tax tenant.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes responses so you can integrate once and rely on consistent objects across modules
  • Aligns with customer entitlements and role-based permissions to ensure compliant access

Use Cases

Entity & Filing Data Sync

  • Mirror legal entities, jurisdictions, and fiscal calendars into your GRC/audit platform
  • Keep filing statuses and due dates current for SLA tracking and governance
  • Normalize identifiers (EIN, registration numbers) to align with ERP/GL and compliance tools

Indirect Tax Rate Monitoring

  • Ingest sales/use tax rates by jurisdiction to validate transaction tax calculations
  • Detect rate changes and propagate updates to billing, e-commerce, and AP systems
  • Maintain evidence trails with source citations for audit readiness

Fixed Assets & Depreciation

  • Sync asset registers and multi-book depreciation for reconciliation and reporting
  • Validate methods, conventions, bonus/Section 179 usage against tax rules
  • Generate variance views across GAAP vs tax and tie out to workpapers

ASC 740 Tax Provision & Journal Posting

  • Pull provision outputs (ETR, current/deferred tax expense, DTA/DTL) for period close
  • Export normalized journal entries to NetSuite, SAP, or Oracle ERP
  • Track approvals and attach supporting documentation to your audit workflows

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_btx_21f8a2",
    "name": "Tax Manager",
    "entitlements": ["entities", "filings", "fixed_assets", "provisions", "rates"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Entities

GET /entities: List legal entities with identifiers, jurisdictions, and fiscal calendars.

Query parameters

  • parentEntityId: string
  • jurisdiction: string (e.g., US-NY, US-CA, GB)
  • status: active | inactive | consolidated
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "entityId": "ent_corp_1029a",
      "name": "Acme Holdings, Inc.",
      "ein": "12-3456789",
      "country": "US",
      "jurisdictions": ["US-NY", "US-CA", "US-TX"],
      "fiscalYearEnd": "12-31",
      "status": "active",
      "parentEntityId": null,
      "nexus": [
        {"jurisdiction": "US-NY", "effectiveDate": "2024-01-01"},
        {"jurisdiction": "US-CA", "effectiveDate": "2023-03-01"}
      ],
      "upcomingFilings": [
        {"taxType": "income", "jurisdiction": "US-NY", "periodEnd": "2024-12-31", "dueDate": "2025-03-15"},
        {"taxType": "sales_use", "jurisdiction": "US-CA", "periodEnd": "2024-12-31", "dueDate": "2025-01-31"}
      ],
      "updatedAt": "2026-01-20T13:45:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Filings

GET /filings: List planned, in-progress, filed, or amended returns with amounts and due dates.

Query parameters

  • entityId: string
  • taxType: income | sales_use | payroll | property
  • periodStart, periodEnd: ISO 8601 dates
  • status: planned | in_progress | filed | amended | overdue
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "filingId": "fil_2024_q4_ny_sut",
      "entityId": "ent_corp_1029a",
      "taxType": "sales_use",
      "jurisdiction": "US-NY",
      "periodStart": "2024-10-01",
      "periodEnd": "2024-12-31",
      "dueDate": "2025-01-20",
      "status": "in_progress",
      "amountDue": 18452.37,
      "extensionFiled": false,
      "efile": {
        "enabled": true,
        "receiptNumber": null,
        "lastAttemptAt": null
      },
      "attachments": [
        {"fileName": "ny_sut_workpaper_q4_2024.xlsx", "uploadToken": "upl_44af02"}
      ],
      "updatedAt": "2026-01-21T11:02:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Fixed Assets

GET /fixed-assets: List fixed assets with multi-book depreciation, methods, and conventions.

Query parameters

  • entityId: string
  • book: gaap | tax | ifrs (optional; defaults to all)
  • placedInServiceFrom, placedInServiceTo: ISO 8601 dates
  • assetClass: machinery | furniture | software | leasehold_improvements | other
  • disposed: true | false
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "assetId": "fa_7b21c0",
      "description": "CNC Milling Machine",
      "location": "US-TX",
      "placedInServiceDate": "2024-02-15",
      "cost": 125000.00,
      "books": [
        {"book": "gaap", "method": "straight_line", "lifeYears": 7, "convention": "half_month"},
        {"book": "tax", "method": "macrs_gds_7", "lifeYears": 7, "convention": "half_year", "bonusPercent": 80, "section179": 0}
      ],
      "currentYearDepreciation": {"gaap": 8928.57, "tax": 9200.00},
      "accumulatedDepreciation": {"gaap": 8928.57, "tax": 9200.00},
      "netBookValue": {"gaap": 116071.43, "tax": 115800.00},
      "disposed": false,
      "updatedAt": "2026-01-22T08:15:12Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Tax Provisions

POST /provisions: Create an ASC 740 provision calculation for a period and retrieve normalized outputs and journals.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/provisions \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "entityId": "ent_corp_1029a",
    "periodEnd": "2024-12-31",
    "trialBalance": {
      "incomeBeforeTax": 1100000.00,
      "stateTaxes": 0.00,
      "permanentDifferences": [{"description": "Non-deductible meals", "amount": 15000.00}],
      "temporaryDifferences": [{"description": "Depreciation timing", "amount": -45000.00}]
    },
    "valuationAllowance": [{"jurisdiction": "US", "percent": 0.00}],
    "rateOverrides": [{"jurisdiction": "US", "statutoryRate": 21.0}],
    "referenceId": "close-2024-q4"
  }'

Example response

{
  "provisionId": "prov_24q4_1029a",
  "status": "calculated",
  "effectiveTaxRate": 22.3,
  "currentTaxExpense": 245300.00,
  "deferredTaxExpense": -9450.00,
  "totalTaxExpense": 235850.00,
  "dtaDtl": [
    {"type": "DTA", "description": "Accruals", "amount": 12000.00},
    {"type": "DTL", "description": "Depreciation", "amount": 21450.00}
  ],
  "journals": [
    {"account": "Income Tax Expense", "debit": 235850.00, "credit": 0.00},
    {"account": "Deferred Tax Asset", "debit": 12000.00, "credit": 0.00},
    {"account": "Deferred Tax Liability", "debit": 0.00, "credit": 21450.00},
    {"account": "Income Taxes Payable", "debit": 0.00, "credit": 245300.00}
  ],
  "attachments": [
    {"fileName": "asc740_workpaper_2024q4.pdf", "downloadUrl": "https://files.supergood.ai/dl/upl_9f231a"}
  ],
  "updatedAt": "2026-01-22T10:31:44Z"
}

Get full API Specs →


Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of entities, filings, rates, fixed assets, and provision objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Bloomberg Tax role-based permissions and licensing
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., provision runs, filing status changes)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume entity/filing sync and provision/fixed asset processing
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Bloomberg Tax adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Bloomberg Tax evolves.

Schedule Integration Call →


Frequently Asked Questions

Q: Which Bloomberg Tax modules can this integration cover?

Supergood supports workflows across commonly used modules such as Corporate Tax Provision (ASC 740), Fixed Assets/Depreciation (multi-book), Indirect Tax Rates, Entities/Jurisdictions, and Filing Calendars/Workpapers, subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you export provision journals to our accounting system?

Yes. We normalize provision outputs and journal entries to match your ERP/GL schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with NetSuite, SAP, and Oracle.

Q: Are indirect tax rates and source citations included?

Where licensed, we provide rate tables with effective dates and jurisdiction codes, and include source metadata or citation references for audit trails.



Ready to automate your Bloomberg Tax workflows?

Supergood can have your Bloomberg Tax integration live in days with no ongoing engineering maintenance.

Get Started →

Read more