--- title: "Tax detail" method: GET path: "/api/v1/fundamentals/{ticker}/taxes" tags: ["Fundamentals"] --- # Tax detail `GET /api/v1/fundamentals/{ticker}/taxes` Income tax breakdown: current/deferred, federal/state/foreign, effective rate, deferred tax assets/liabilities. ## Path parameters - `ticker` string, required — Security ticker symbol. ## Query parameters - `periods` integer — Number of periods (granularity-dependent). - `form` '10-K' | '10-Q' — SEC filing form type (10-K annual, 10-Q quarterly). ## Response `200` Income tax breakdown across reported periods. - EnvelopeFundamentalsTickerTaxesData - `data` FundamentalsTickerTaxesData, required - `income_tax_expense` AccountsReceivableNetItem[], required — Array of income-tax-expense observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `current_income_tax` unknown[], required — Array of current-income-tax observations. - unknown - `current_federal_tax` AccountsReceivableNetItem[], required — Array of current-federal-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `current_state_tax` AccountsReceivableNetItem[], required — Array of current-state-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `current_foreign_tax` AccountsReceivableNetItem[], required — Array of current-foreign-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_income_tax` AccountsReceivableNetItem[], required — Array of deferred-income-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_federal_tax` AccountsReceivableNetItem[], required — Array of deferred-federal-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_state_tax` AccountsReceivableNetItem[], required — Array of deferred-state-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_foreign_tax` AccountsReceivableNetItem[], required — Array of deferred-foreign-tax observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `effective_tax_rate` DividendsPerShareItem[], required — Array of effective-tax-rate observations. - `end` string, required — End of the data range or time window. - `val` number, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `statutory_tax_rate` DividendsPerShareItem[], required — Array of statutory-tax-rate observations. - `end` string, required — End of the data range or time window. - `val` number, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `domestic_income` unknown[], required — Array of domestic-income observations. - unknown - `foreign_income` AccountsReceivableNetItem[], required — Array of foreign-income observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_tax_assets_gross` AccountsReceivableNetItem[], required — Array of gross deferred-tax-asset observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_tax_assets_net` AccountsReceivableNetItem[], required — Array of net deferred-tax-asset observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `deferred_tax_liabilities` AccountsReceivableNetItem[], required — Array of deferred-tax-liabilities observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `valuation_allowance` AccountsReceivableNetItem[], required — Array of valuation-allowance observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `unrecognized_tax_benefits` AccountsReceivableNetItem[], required — Array of unrecognized-tax-benefit observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `income_taxes_paid` AccountsReceivableNetItem[], required — Array of income-taxes-paid observations. - `end` string, required — End of the data range or time window. - `val` integer, required — Reported numeric value. - `form` string, required — SEC filing form type (10-K, 10-Q, 8-K, etc). - `filed` string, required — Date the document was filed (YYYY-MM-DD). - `accn` string, required — SEC accession number. - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope. - `endpoint` string, required — Requested endpoint path. - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request. - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced. - `provider` string, required — API name and version. - `source` string, nullable — Identifier of the primary upstream source used for this response. - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response. - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data. - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried. - `cached` boolean, nullable — True when this response was served from the internal cache. - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data. ## Other responses - `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401. - `422` — Validation Error - `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window. - `503` — Upstream source is temporarily unavailable. Retry after a short delay. --- [API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/d3e3d9c28132/schema)