> ## 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. # Event History > Get US municipal bond event history for given ISINs. ## OpenAPI ````yaml post /api/v1/muni_events 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_events: post: tags: [] summary: US municipal bond events description: Get US municipal bond event history for given ISINs. operationId: post_muni_events parameters: [] requestBody: content: application/json: example: isins: - US005824LP01 schema: additionalProperties: false properties: isins: description: >- International Securities Identification Number (ISIN), unique 12-character code for the security. items: example: US64966HW301 maxLength: 12 minLength: 12 nullable: false type: string x-struct: null x-validate: null type: array x-check: valid_check_digit x-check-error: Invalid ISIN check digit x-struct: null x-transform: upcase x-validate: null required: - isins type: object x-struct: null x-validate: null required: true responses: '200': content: application/json: example: data: - events: - category: creation date: '2024-01-30' details: amount: 240000 description: Primary issuance history: [] name: creation publish_date: '2024-01-30' isin: US005824LP01 total: 1 schema: additionalProperties: false properties: data: description: List of response data objects, often capped to 1000. items: additionalProperties: false properties: events: items: discriminator: mapping: call: $ref: '#/components/schemas/MuniEventsCall' consolidation: $ref: '#/components/schemas/MuniEventsConsolidation' creation: $ref: '#/components/schemas/MuniEventsCreation' defeasance: $ref: '#/components/schemas/MuniEventsDefeasance' identifier_relabel: $ref: >- #/components/schemas/MuniEventsIdentifierRelabel split: $ref: '#/components/schemas/MuniEventsSplit' split_and_suspend: $ref: >- #/components/schemas/MuniEventsSplitAndSuspend propertyName: name oneOf: - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- A portion of the bond is split into a new identifier while the remaining portion continues to use the current identifier. properties: child_amount: nullable: false type: number x-struct: null x-validate: null child_description: nullable: false type: string x-struct: null x-validate: null child_isin: nullable: false type: string x-struct: null x-validate: null required: - child_amount - child_description - child_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - split nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsSplit type: object x-struct: null x-validate: null - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- Information about how the bond was brought to market. properties: amount: nullable: true type: number x-struct: null x-validate: null description: nullable: false type: string x-struct: null x-validate: null history: items: properties: amount: nullable: true type: number x-struct: null x-validate: null date: format: date nullable: false type: string x-struct: null x-validate: null description: nullable: false type: string x-struct: null x-validate: null isin: nullable: false type: string x-struct: null x-validate: null required: - date - description - isin type: object x-struct: null x-validate: null nullable: false type: array x-struct: null x-validate: null parent_isin: nullable: true type: string x-struct: null x-validate: null required: - description - history type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - creation nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsCreation type: object x-struct: null x-validate: null - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- Principal consolidation of another bond with this bond. This would typically only happen for the defeased portion of a bond resulting from a partial defeasance. properties: amount: nullable: true type: number x-struct: null x-validate: null description: nullable: false type: string x-struct: null x-validate: null parent_isin: nullable: false type: string x-struct: null x-validate: null required: - description - parent_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - consolidation nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsConsolidation type: object x-struct: null x-validate: null - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The assignment of a new identifier due to a structural change, such as adding insurance or becoming 'pre-refunded'. properties: child_amount: nullable: false type: number x-struct: null x-validate: null child_description: nullable: false type: string x-struct: null x-validate: null child_isin: nullable: false type: string x-struct: null x-validate: null required: - child_amount - child_description - child_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - identifier_relabel nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsIdentifierRelabel type: object x-struct: null x-validate: null - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The bond is split into two new identifiers and the current identifier is suspended. properties: child_1_amount: nullable: false type: number x-struct: null x-validate: null child_1_description: nullable: false type: string x-struct: null x-validate: null child_1_isin: nullable: false type: string x-struct: null x-validate: null child_2_amount: nullable: false type: number x-struct: null x-validate: null child_2_description: nullable: false type: string x-struct: null x-validate: null child_2_isin: nullable: false type: string x-struct: null x-validate: null required: - child_1_amount - child_1_description - child_1_isin - child_2_amount - child_2_description - child_2_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - split_and_suspend nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsSplitAndSuspend type: object x-struct: null x-validate: null - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The issuer exercises its right to retire some or all of the bond issue before maturity. properties: amount: nullable: true type: number x-struct: null x-validate: null redemption_price: description: >- The call price may also appear as redemption price, and appears as percentage of 100 nullable: true oneOf: - additionalProperties: false nullable: false properties: premium_in_pct: maximum: 1000 minimum: -1000 nullable: false type: number x-struct: null x-validate: null type: enum: - accreted-value - par nullable: false type: string x-struct: null x-validate: null required: - premium_in_pct - type type: object x-struct: null x-validate: null - additionalProperties: false properties: benchmark: enum: - blended-treasury-yield - mmd - treasury - usd-isdaswap nullable: true type: string x-struct: null x-validate: null premium_in_pct: maximum: 1000 minimum: -1000 nullable: true type: number x-struct: null x-validate: null type: enum: - make-whole nullable: false type: string x-struct: null x-validate: null required: - benchmark - premium_in_pct - type type: object x-struct: null x-validate: null x-struct: null x-validate: null type: enum: - mandatory_full - mandatory_partial - optional_full - optional_partial nullable: false type: string x-struct: null x-validate: null required: - type type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - call nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsCall type: object x-struct: null x-validate: null - properties: category: description: >- The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: >- Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The issuer sets aside funds (usually US Treasuries) in escrow to pay off the bonds, effectively removing the debt from their balance sheet. properties: amount: nullable: false type: number x-struct: null x-validate: null type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - defeasance nullable: false type: string x-struct: null x-validate: null publish_date: description: >- Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsDefeasance type: object x-struct: null x-validate: null type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null isin: description: >- International Securities Identification Number (ISIN), unique 12-character code for the security. example: US64966HW301 maxLength: 12 minLength: 12 nullable: false type: string x-check: valid_check_digit x-check-error: Invalid ISIN check digit x-struct: null x-transform: upcase x-validate: null required: - events - isin 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: MuniEventsResponse type: object x-struct: null x-validate: null description: Event data '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: schemas: MuniEventsCall: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The issuer exercises its right to retire some or all of the bond issue before maturity. properties: amount: nullable: true type: number x-struct: null x-validate: null redemption_price: description: >- The call price may also appear as redemption price, and appears as percentage of 100 nullable: true oneOf: - additionalProperties: false nullable: false properties: premium_in_pct: maximum: 1000 minimum: -1000 nullable: false type: number x-struct: null x-validate: null type: enum: - accreted-value - par nullable: false type: string x-struct: null x-validate: null required: - premium_in_pct - type type: object x-struct: null x-validate: null - additionalProperties: false properties: benchmark: enum: - blended-treasury-yield - mmd - treasury - usd-isdaswap nullable: true type: string x-struct: null x-validate: null premium_in_pct: maximum: 1000 minimum: -1000 nullable: true type: number x-struct: null x-validate: null type: enum: - make-whole nullable: false type: string x-struct: null x-validate: null required: - benchmark - premium_in_pct - type type: object x-struct: null x-validate: null x-struct: null x-validate: null type: enum: - mandatory_full - mandatory_partial - optional_full - optional_partial nullable: false type: string x-struct: null x-validate: null required: - type type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - call nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsCall type: object x-struct: null x-validate: null MuniEventsConsolidation: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- Principal consolidation of another bond with this bond. This would typically only happen for the defeased portion of a bond resulting from a partial defeasance. properties: amount: nullable: true type: number x-struct: null x-validate: null description: nullable: false type: string x-struct: null x-validate: null parent_isin: nullable: false type: string x-struct: null x-validate: null required: - description - parent_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - consolidation nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsConsolidation type: object x-struct: null x-validate: null MuniEventsCreation: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: Information about how the bond was brought to market. properties: amount: nullable: true type: number x-struct: null x-validate: null description: nullable: false type: string x-struct: null x-validate: null history: items: properties: amount: nullable: true type: number x-struct: null x-validate: null date: format: date nullable: false type: string x-struct: null x-validate: null description: nullable: false type: string x-struct: null x-validate: null isin: nullable: false type: string x-struct: null x-validate: null required: - date - description - isin type: object x-struct: null x-validate: null nullable: false type: array x-struct: null x-validate: null parent_isin: nullable: true type: string x-struct: null x-validate: null required: - description - history type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - creation nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsCreation type: object x-struct: null x-validate: null MuniEventsDefeasance: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The issuer sets aside funds (usually US Treasuries) in escrow to pay off the bonds, effectively removing the debt from their balance sheet. properties: amount: nullable: false type: number x-struct: null x-validate: null type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - defeasance nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsDefeasance type: object x-struct: null x-validate: null MuniEventsIdentifierRelabel: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The assignment of a new identifier due to a structural change, such as adding insurance or becoming 'pre-refunded'. properties: child_amount: nullable: false type: number x-struct: null x-validate: null child_description: nullable: false type: string x-struct: null x-validate: null child_isin: nullable: false type: string x-struct: null x-validate: null required: - child_amount - child_description - child_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - identifier_relabel nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsIdentifierRelabel type: object x-struct: null x-validate: null MuniEventsSplit: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- A portion of the bond is split into a new identifier while the remaining portion continues to use the current identifier. properties: child_amount: nullable: false type: number x-struct: null x-validate: null child_description: nullable: false type: string x-struct: null x-validate: null child_isin: nullable: false type: string x-struct: null x-validate: null required: - child_amount - child_description - child_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - split nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsSplit type: object x-struct: null x-validate: null MuniEventsSplitAndSuspend: properties: category: description: The general category of event that occured. nullable: false type: string x-struct: null x-validate: null date: description: Date the event occured in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null details: description: >- The bond is split into two new identifiers and the current identifier is suspended. properties: child_1_amount: nullable: false type: number x-struct: null x-validate: null child_1_description: nullable: false type: string x-struct: null x-validate: null child_1_isin: nullable: false type: string x-struct: null x-validate: null child_2_amount: nullable: false type: number x-struct: null x-validate: null child_2_description: nullable: false type: string x-struct: null x-validate: null child_2_isin: nullable: false type: string x-struct: null x-validate: null required: - child_1_amount - child_1_description - child_1_isin - child_2_amount - child_2_description - child_2_isin type: object x-struct: null x-validate: null name: description: The specific kind of event that occured. enum: - split_and_suspend nullable: false type: string x-struct: null x-validate: null publish_date: description: Date the event was published in ISO-8601 format (YYYY-MM-DD). format: date nullable: false type: string x-struct: null x-validate: null title: MuniEventsSplitAndSuspend type: object x-struct: null x-validate: null securitySchemes: authorization: scheme: bearer type: http ````