---
title: "424B2 structured note filings"
method: GET
path: "/api/markets/structured-products"
tags: ["Companies"]
---

# 424B2 structured note filings

`GET /api/markets/structured-products`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/structured-products`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Docs: https://xoomar.com/markets/api/structured-products

## Query parameters

- `issuer` string
- `underlying` string
- `noteType` 'autocallable' | 'buffered' | 'barrier' | 'income'
- `minCoupon` number
- `maxCoupon` number
- `days` integer
- `cursor` string

## Response `200`

OK

- object
  - `data` object[]
    - `accessionNo` string: EDGAR accession number, unique per filing
    - `issuer` string: Filing entity (BofA Finance, Morgan Stanley Finance...)
    - `formType` string: 424B2 or FWP
    - `filedAt` string, date: Filing date, YYYY-MM-DD
    - `pricingDate` string, nullable: Pricing/trade date when stated
    - `underlyings` unknown[], nullable: Parsed underlying symbols (SPX, NDX, NVDA...). Populated for priced notes; preliminary filings carry nulls
      - unknown
    - `noteType` string, nullable: autocallable, buffered, barrier, or income. Populated for priced notes; preliminary filings carry nulls
    - `coupon` string, nullable: Annual coupon %; null on preliminary filings, which are filed before the rate is set
    - `capPct` string, nullable: Maximum return as % of initial level when the note is capped
    - `barrierPct` string, nullable: Barrier/threshold as % of initial level. Populated for priced notes; preliminary filings carry nulls
    - `principalUsd` string, nullable: Aggregate principal when stated (final filings)
    - `docUrl` string: Link to the primary SEC document
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `nextCursor` string, nullable: Send it back as cursor for the next 200 rows; null on the last page
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)