> ## Documentation Index > Fetch the complete documentation index at: https://docs.terrapinfinance.com/llms.txt > Use this file to discover all available pages before exploring further. # Outstanding Statistics > Aggregate statistics on currently outstanding US municipal debt: total outstanding par value, number of CUSIPs, and number of unique issuing entities. Excludes commercial paper and new issues still without a final OS. ## OpenAPI ````yaml post /api/v1/muni_stats_outstanding openapi: 3.0.0 info: title: Terrapin API version: 1.0.0 servers: - url: https://terrapinfinance.com variables: {} security: - authorization: [] tags: [] paths: /api/v1/muni_stats_outstanding: post: tags: [] summary: US municipal bond outstanding statistics description: >- Aggregate statistics on currently outstanding US municipal debt: total outstanding par value, number of CUSIPs, and number of unique issuing entities. Excludes commercial paper and new issues still without a final OS. operationId: post_muni_stats_outstanding parameters: [] requestBody: content: application/json: example: group_by: use_sectors sources_of_repayment: - General Obligation states: - CA - NY schema: additionalProperties: false properties: capital_purpose: description: > Capital purpose, indicating whether the bond proceeds are used for new projects, to refund prior bonds, or both. items: enum: - mixed - new money - refunding nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-validate: null group_by: default: none description: > Optional dimension to split outstanding results. - `none`: No split, one aggregate row. - scalar dimensions: `state`, `source_of_repayment`, `rating_group`, `interest_type`, `seniority`, `capital_purpose` - use-of-funds dimensions: `use_sectors`, `use_categories`, `uses_of_proceeds` - boolean dimensions: `is_federally_taxable`, `is_amt`, `is_bank_qualified`, `is_insured`, `is_green`, `is_social`, `is_sustainable`, `is_pac`, `is_callable` (returned as `is_` / `not_`) enum: - capital_purpose - interest_type - is_amt - is_bank_qualified - is_callable - is_federally_taxable - is_green - is_insured - is_pac - is_social - is_sustainable - none - rating_group - seniority - source_of_repayment - state - use_categories - use_sectors - uses_of_proceeds nullable: false type: string x-struct: null x-transform: downcase x-validate: null interest_types: description: > Types of interest: - `fixed rate`: The bond pays a fixed interest rate throughout its life. - `cab`: Capital Appreciation Bond (CAB), interest accrues and is paid at maturity rather than periodically. - `variable rate`: The bond's interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI). - `term rate`: The bond pays interest at a rate set for a specific term or period. - `cab-to-fixed`: The bond starts as a capital appreciation bond and converts to a fixed rate bond. - `step rate`: The bond's interest rate increases ("steps up") at predetermined intervals. - `zero rate / discount rate`: A bond that does not pay or accrue interest. items: enum: - cab - cab-to-fixed - fixed rate - step rate - term rate - variable rate - zero rate / discount rate nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-transform: downcase x-validate: null is_amt: description: | Whether the bond is an Alternative Minimum Tax (AMT) bond. nullable: false type: boolean x-struct: null x-validate: null is_bank_qualified: description: | Whether the bond is bank qualified. nullable: false type: boolean x-struct: null x-validate: null is_federally_taxable: description: | Whether the bond is federally taxable. nullable: false type: boolean x-struct: null x-validate: null is_green: description: | Whether the bond is a green bond. nullable: false type: boolean x-struct: null x-validate: null is_insured: description: | Whether the bond is insured by a bond insurance company. nullable: false type: boolean x-struct: null x-validate: null is_pac: description: | Whether the bond is a Planned Amortization Class (PAC) bond. nullable: false type: boolean x-struct: null x-validate: null is_social: description: | Whether the bond is a social bond. nullable: false type: boolean x-struct: null x-validate: null is_sustainable: description: | Whether the bond is a sustainable bond. nullable: false type: boolean x-struct: null x-validate: null rating_group: description: > Credit rating group: - `investment_grade`: Bonds with high credit quality, typically considered safe and low risk. - `high_yield`: Bonds with lower credit quality, typically considered riskier and higher yield. enum: - high_yield - investment_grade nullable: true type: string x-struct: null x-validate: null seniority: description: > Seniority of the bond, derived from the series name, ordered from most senior to most junior. items: enum: - first_lien - junior - second_lien - senior - subordinate nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-transform: downcase x-validate: null sources_of_repayment: description: > Sources of repayment for municipal bonds. Determines how the bond will be repaid. - `Revenue`: Repaid from specific project revenues (e.g., tolls, utilities). - `General Obligation`: Repaid from the issuer's general fund. - `Double Barrel`: A combination of General Obligation and Revenue sources. items: enum: - Double Barrel - General Obligation - Revenue nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-validate: null states: description: > US states or territory where the bond is issued (ANSI 2-letter code). items: example: IL maxLength: 2 minLength: 2 nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-transform: upcase x-validate: null use_categories: description: > Filter bonds by use categories (middle level of use of funds hierarchy). For the complete taxonomy, see the [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy) reference page. items: enum: - airport - bridges - communication - culture - economic development - electrical - essential services - gas - gas prepay - general purpose - health system - higher education - hospitals - industrial development - military housing - miscellaneous - multi-family housing - parking - port - power - pre-school - primary and secondary education - public housing - public transit - recreational - roads - senior living - single family housing - student loan - waste removal - water and sewer nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-transform: downcase x-validate: null use_sectors: description: > Filter bonds by use sectors (top level of use of funds hierarchy). For the complete taxonomy, see the [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy) reference page. items: enum: - development - education - government - healthcare - housing - miscellaneous - recreation - securitized - transportation - utility nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-transform: downcase x-validate: null uses_of_proceeds: description: > Filter bonds by uses of proceeds (most granular level of use of funds hierarchy). For the complete taxonomy, see the [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy) reference page. items: enum: - airport - alternative source power - assisted living - broadband - buses - charter school - coal power - combined port authority - community centre - community college - continuing care retirement community - correctional facilities - courts - critical access hospital - development district - electrical infrastructure - ferries - fire - flood control - gas infrastructure - gas power - gas prepay - health system - hospitality - independent living - industrial development - irrigation - library - local hfa multi-family housing - local hfa single family housing - local standalone multi-family housing - local standalone single family housing - military housing - miscellaneous - museum - non-toll bridges - non-toll roads - nuclear power - nursing home - office buildings - parking facilities - parks - police - pollution control - pre-school and daycare - private college - public buildings - public college - public housing - public school district - regional toll bridges - regional toll roads - sewer - shopping centres - solar power - specialty hospital - stadium - standalone hospital - standalone port - standalone public school - state hfa multi-family housing - state hfa single family housing - state toll bridges - state toll roads - storm water - student housing - student loan - telephone - trains - tribal - waste removal - water - wind power nullable: false type: string x-struct: null x-validate: null type: array x-struct: null x-transform: downcase x-validate: null type: object x-struct: null x-validate: null required: true responses: '200': content: application/json: example: data: - cusip_count: 4213 entity_count: 318 group_key: education outstanding_par_value: 1284500000 total: 1 schema: additionalProperties: false properties: data: description: List of response data objects, often capped to 1000. items: additionalProperties: false properties: cusip_count: description: Number of outstanding CUSIPs matching the filters. nullable: false type: integer x-struct: null x-validate: null entity_count: description: >- Number of unique issuing entities matching the filters. nullable: false type: integer x-struct: null x-validate: null group_key: description: >- Grouping bucket value when `group_by` is provided. Omitted for ungrouped responses. nullable: true type: string x-struct: null x-validate: null outstanding_par_value: description: >- Total outstanding par value of bonds matching the filters. nullable: true type: number x-struct: null x-validate: null required: - cusip_count - entity_count - group_key - outstanding_par_value type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null total: description: >- Total number of results in the database that match the query filters. type: integer x-struct: null x-validate: null required: - data - total title: MuniStatsOutstandingResponse type: object x-struct: null x-validate: null description: Outstanding statistics '401': content: application/json: schema: additionalProperties: false properties: errors: items: additionalProperties: false properties: detail: example: Unauthorized type: string x-struct: null x-validate: null reason: example: >- Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade. type: string x-struct: null x-validate: null required: - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors type: object x-struct: null x-validate: null description: Unauthorized '402': content: application/json: schema: additionalProperties: false properties: errors: items: additionalProperties: false properties: detail: example: Payment Required type: string x-struct: null x-validate: null reason: example: >- You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade. type: string x-struct: null x-validate: null required: - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors type: object x-struct: null x-validate: null description: Payment Required '403': content: application/json: schema: additionalProperties: false properties: errors: items: additionalProperties: false properties: detail: example: Forbidden type: string x-struct: null x-validate: null reason: example: >- Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade. type: string x-struct: null x-validate: null required: - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors type: object x-struct: null x-validate: null description: Forbidden '422': content: application/json: schema: properties: errors: items: properties: detail: example: 'Invalid string. Got: integer' type: string x-struct: null x-validate: null source: properties: pointer: example: /isins/0 type: string x-struct: null x-validate: null required: - pointer type: object x-struct: null x-validate: null title: example: Invalid value type: string x-struct: null x-validate: null required: - detail - source - title type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors type: object x-struct: null x-validate: null description: Unprocessable Entity '429': content: application/json: schema: additionalProperties: false properties: errors: items: additionalProperties: false properties: detail: example: Too Many Requests type: string x-struct: null x-validate: null reason: type: string x-struct: null x-validate: null required: - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors type: object x-struct: null x-validate: null description: Too Many Requests '500': content: application/json: schema: additionalProperties: false properties: errors: items: additionalProperties: false properties: detail: example: Internal Server Error type: string x-struct: null x-validate: null reason: type: string x-struct: null x-validate: null required: - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors type: object x-struct: null x-validate: null description: Internal Server Error callbacks: {} components: securitySchemes: authorization: scheme: bearer type: http ````