{
"errors": [
{
"detail": "Unauthorized",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Payment Required",
"reason": "You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Forbidden",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
Pass isins for the live ratings of those securities, updated_since for
every rating added or changed since that UTC instant, or both. Ratings often
arrive days after their rating_date, and updated_since still returns
them.
S&P deletes actions as well as issuing them. With updated_since, deleted
actions are returned too, with is_deleted true, so an incremental pull
can drop them.
{
"errors": [
{
"detail": "Unauthorized",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Payment Required",
"reason": "You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Forbidden",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
cursor
string | null
The next_cursor of the previous page. Leave out, or send null, for the first page. Only cursor and limit may change between pages. See Pagination.
isins
string[]
International Securities Identification Number (ISIN), unique 12-character code for the security.
Required string length: 12
limit
integer
default:100
Number of results per page, at most your tier's response size limit. A limit of 0 returns only total, the number of matching results.
Required range: x >= 0
sort
enum<string>[]
Fields to sort by. Prefix a field with '-' for descending order. Results with no value come last. See Order for how ties are broken.
Available options:
-creditwatch,
-creditwatch_date,
-current_rating_symbol,
-cusip,
-cwol_action_word,
-cwol_ind,
-is_deleted,
-maturity_date,
-org_debt_type_code,
-outlook,
-outlook_date,
-prior_creditwatch,
-prior_outlook,
-prior_rating_symbol,
-rating_action_word,
-rating_date,
-rating_detail_id,
-rating_qualifier,
-rating_symbol,
-rating_type_code,
-regulatory_indicator,
-regulatory_qualifier,
-updated_at,
creditwatch,
creditwatch_date,
current_rating_symbol,
cusip,
cwol_action_word,
cwol_ind,
is_deleted,
maturity_date,
org_debt_type_code,
outlook,
outlook_date,
prior_creditwatch,
prior_outlook,
prior_rating_symbol,
rating_action_word,
rating_date,
rating_detail_id,
rating_qualifier,
rating_symbol,
rating_type_code,
regulatory_indicator,
regulatory_qualifier,
updated_at
updated_since
string<date-time>
Optional filter to only return ratings added or changed since the given UTC instant.
Accepts an ISO-8601 date-time (YYYY-MM-DDThh:mm:ssZ).
To poll for updates, pass the time you requested the first page of your previous poll,
then upsert the results by rating_detail_id: some may be ratings you already have.
Response
S&P municipal instrument ratings
data
object[]
required
One page of at most limit results. See Pagination.
Show child attributes
next_cursor
string | null
required
Send as cursor to get the next page. null on the last page, or when limit is 0.
total
integer
required
Total number of results in the database that match the query filters.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Terrapin","colors":{"primary":"#5cc9c4","light":"#78d9d4","dark":"#3a9e99"},"logo":{"light":"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/logo.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=259202f1a61642e74e1194ad39a9e024","dark":"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/logo.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=259202f1a61642e74e1194ad39a9e024","href":"https://terrapinfinance.com"},"favicon":"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/favicon-32x32.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=58578f8d2047f9bcac70a1a5bcff33d4","appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#f2f1ec","dark":"#101210"}},"navbar":{"links":[{"href":"https://calendly.com/miguel-terrapinfinance/terrapin-fixed-income-data","label":"Book a demo"}],"primary":{"type":"button","label":"Get API key","href":"https://terrapinfinance.com/app"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/terrapin-finance"}},"seo":{"metatags":{"og:image":"https://terrapinfinance.com/images/og/documentation.png","twitter:image":"https://terrapinfinance.com/images/og/documentation.png"}},"styling":{"codeblocks":{"theme":{"light":"catppuccin-latte","dark":"github-dark-high-contrast"}},"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"terrapinfinance","hasAudioNarration":false,"actualSubdomain":"terrapinfinance","customDomains":["docs.terrapinfinance.com"],"gitSource":{"type":"github","owner":"terrapin-code","repo":"terrapin-app","deployBranch":"main","contentDirectory":"api-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc2d7c20d97acf6c3601f9","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":48},{"language":"default","tag":"US municipal securities","count":14},{"language":"default","tag":"Credit Intel Platform","count":13},{"language":"default","tag":"Government \u0026 corporate bonds (deprecated)","count":5},{"language":"default","tag":"Fixed income securities","count":5},{"language":"default","tag":"US agency bonds (deprecated)","count":5},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Coverage","count":5},{"language":"default","tag":"US municipal bond statistics","count":4},{"language":"default","tag":"Data dictionaries","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-endpoints/us-municipal-bond-ratings-snp-instruments","slug":"/api-endpoints/us-municipal-bond-ratings-snp-instruments","pageMetadata":{"title":"S\u0026P Instrument Ratings","openapi":"post /api/v1/muni_ratings_snp_instruments","description":"Requires an existing license with S\u0026P.\n\nPass `isins` for the live ratings of those securities, `updated_since` for\nevery rating added or changed since that UTC instant, or both. Ratings often\narrive days after their `rating_date`, and `updated_since` still returns\nthem.\n\nS\u0026P deletes actions as well as issuing them. With `updated_since`, deleted\nactions are returned too, with `is_deleted` true, so an incremental pull\ncan drop them.\n","href":"/api-endpoints/us-municipal-bond-ratings-snp-instruments"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Requires an existing license with S\u0026P.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Pass \", _jsx(_components.code, {\n children: \"isins\"\n }), \" for the live ratings of those securities, \", _jsx(_components.code, {\n children: \"updated_since\"\n }), \" for\\nevery rating added or changed since that UTC instant, or both. Ratings often\\narrive days after their \", _jsx(_components.code, {\n children: \"rating_date\"\n }), \", and \", _jsx(_components.code, {\n children: \"updated_since\"\n }), \" still returns\\nthem.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"S\u0026P deletes actions as well as issuing them. With \", _jsx(_components.code, {\n children: \"updated_since\"\n }), \", deleted\\nactions are returned too, with \", _jsx(_components.code, {\n children: \"is_deleted\"\n }), \" true, so an incremental pull\\ncan drop them.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsx(Warning,{children:_jsx(_components.p,{children:`Access requires an existing license with S\u0026P.`})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"catppuccin-latte","dark":"github-dark-high-contrast"}},"config":{},"pageMetadata":{"title":"S\u0026P Instrument Ratings","openapi":"post /api/v1/muni_ratings_snp_instruments","description":"Requires an existing license with S\u0026P.\n\nPass `isins` for the live ratings of those securities, `updated_since` for\nevery rating added or changed since that UTC instant, or both. Ratings often\narrive days after their `rating_date`, and `updated_since` still returns\nthem.\n\nS\u0026P deletes actions as well as issuing them. With `updated_since`, deleted\nactions are returned too, with `is_deleted` true, so an incremental pull\ncan drop them.\n","href":"/api-endpoints/us-municipal-bond-ratings-snp-instruments"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"callbacks":{},"description":"Requires an existing license with S\u0026P.\n\nPass `isins` for the live ratings of those securities, `updated_since` for\nevery rating added or changed since that UTC instant, or both. Ratings often\narrive days after their `rating_date`, and `updated_since` still returns\nthem.\n\nS\u0026P deletes actions as well as issuing them. With `updated_since`, deleted\nactions are returned too, with `is_deleted` true, so an incremental pull\ncan drop them.\n","operationId":"post_muni_ratings_snp_instruments","parameters":[],"requestBody":"ca0a8885-eb0d-4884-bc03-32dd1a87d822","responses":{"200":"9d62e79d-69e3-48a6-aefe-a82a3a35879c","401":"887fbffd-697c-4138-b696-85173b8cd07a","402":"c7d9db85-7853-46d9-923a-58d0968e8414","403":"c06efb02-4395-4811-b642-52b0751479ae","422":"52faf3a2-a180-4f40-a273-17e078478974","429":"8b9c35d3-347e-456a-9ffb-2b424663a524","500":"5ec2a56e-e05c-44f4-acab-955f6333e15b"},"summary":"S\u0026P municipal bond instrument ratings","tags":[],"method":"post","type":"path","servers":["1d267ed8-7ffc-4f6a-862e-b2d42318952c"],"security":["e12cca51-4bdd-4508-baae-7962af23d0d8"],"path":"/api/v1/muni_ratings_snp_instruments","baseUrlOptions":["https://terrapinfinance.com"],"title":"S\u0026P municipal bond instrument ratings","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"example":{"isins":["US1966324Q32"],"updated_since":"2026-08-01T00:00:00Z"},"schema":{"additionalProperties":false,"properties":{"cursor":{"oneOf":[{"description":"The `next_cursor` of the previous page. Leave out, or send `null`, for the first page. Only `cursor` and `limit` may change between pages. See [Pagination](https://docs.terrapinfinance.com/pagination).","type":"string","uniqueKey":"cursor.oneOf.0","typeLabel":"string"},{"description":"The `next_cursor` of the previous page. Leave out, or send `null`, for the first page. Only `cursor` and `limit` may change between pages. See [Pagination](https://docs.terrapinfinance.com/pagination).","type":"null","uniqueKey":"cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"cursor","typeLabel":"string | null"},"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","uniqueKey":"isins.items.[INDEX]","typeLabel":"string"},"type":"array","x-check":"valid_check_digit","x-check-error":"Invalid ISIN check digit","x-transform":"upcase","uniqueKey":"isins","typeLabel":"string[]"},"limit":{"default":100,"description":"Number of results per page, at most your tier's [response size limit](https://docs.terrapinfinance.com/rate-limits-and-quotas#response-size-limits). A limit of 0 returns only `total`, the number of matching results.","minimum":0,"type":"integer","uniqueKey":"limit","typeLabel":"integer"},"sort":{"description":"Fields to sort by. Prefix a field with '-' for descending order. Results with no value come last. See [Order](https://docs.terrapinfinance.com/pagination#order) for how ties are broken.","items":{"enum":["-creditwatch","-creditwatch_date","-current_rating_symbol","-cusip","-cwol_action_word","-cwol_ind","-is_deleted","-maturity_date","-org_debt_type_code","-outlook","-outlook_date","-prior_creditwatch","-prior_outlook","-prior_rating_symbol","-rating_action_word","-rating_date","-rating_detail_id","-rating_qualifier","-rating_symbol","-rating_type_code","-regulatory_indicator","-regulatory_qualifier","-updated_at","creditwatch","creditwatch_date","current_rating_symbol","cusip","cwol_action_word","cwol_ind","is_deleted","maturity_date","org_debt_type_code","outlook","outlook_date","prior_creditwatch","prior_outlook","prior_rating_symbol","rating_action_word","rating_date","rating_detail_id","rating_qualifier","rating_symbol","rating_type_code","regulatory_indicator","regulatory_qualifier","updated_at"],"type":"string","uniqueKey":"sort.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"sort","typeLabel":"enum\u003cstring>[]"},"updated_since":{"description":"Optional filter to only return ratings added or changed since the given UTC instant.\n\nAccepts an ISO-8601 date-time (YYYY-MM-DDThh:mm:ssZ).\n\nTo poll for updates, pass the time you requested the first page of your previous poll,\nthen upsert the results by `rating_detail_id`: some may be ratings you already have.\n","format":"date-time","nullable":false,"type":"string","uniqueKey":"updated_since","typeLabel":"string\u003cdate-time>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"isins":["US1966324Q32"],"updated_since":"2026-08-01T00:00:00Z"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"9d62e79d-69e3-48a6-aefe-a82a3a35879c":{"content":{"application/json":{"example":{"data":[{"creditwatch":null,"creditwatch_date":null,"current_rating_symbol":"AA-","cusip":"1966324Q3","cwol_action_word":null,"cwol_ind":null,"is_deleted":false,"isin":"US1966324Q32","maturity_date":"2035-02-01T00:00:00Z","org_debt_type_code":null,"outlook":"Stable","outlook_date":"2026-08-01T00:00:00Z","prior_creditwatch":null,"prior_outlook":"Positive","prior_rating_symbol":"A+","rating_action_word":"Upgrade","rating_date":"2026-08-01T00:00:00Z","rating_detail_id":12345,"rating_qualifier":null,"rating_symbol":"AA-","rating_type_code":"STDLONG","regulatory_indicator":null,"regulatory_qualifier":null,"updated_at":"2026-08-01T12:00:00Z"}],"next_cursor":null,"total":1},"schema":{"additionalProperties":false,"properties":{"data":{"description":"One page of at most `limit` results. See [Pagination](https://docs.terrapinfinance.com/pagination).","items":{"additionalProperties":false,"properties":{"creditwatch":{"oneOf":[{"description":"CreditWatch status at the time of the action.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].creditwatch.oneOf.0","typeLabel":"string"},{"description":"CreditWatch status at the time of the action.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].creditwatch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].creditwatch","typeLabel":"string | null"},"creditwatch_date":{"oneOf":[{"description":"Datetime the CreditWatch status was set, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].creditwatch_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Datetime the CreditWatch status was set, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].creditwatch_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].creditwatch_date","typeLabel":"string\u003cdate-time> | null"},"current_rating_symbol":{"oneOf":[{"description":"Rating symbol this action leaves on its line, e.g. `AA-`.","example":"AA-","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].current_rating_symbol.oneOf.0","typeLabel":"string"},{"description":"Rating symbol this action leaves on its line, e.g. `AA-`.","example":"AA-","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].current_rating_symbol.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].current_rating_symbol","typeLabel":"string | null"},"cusip":{"oneOf":[{"description":"CUSIP of the rated municipal security.","example":"1966324Q3","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cusip.oneOf.0","typeLabel":"string"},{"description":"CUSIP of the rated municipal security.","example":"1966324Q3","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].cusip.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].cusip","typeLabel":"string | null"},"cwol_action_word":{"oneOf":[{"description":"CreditWatch / outlook action word, if any.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cwol_action_word.oneOf.0","typeLabel":"string"},{"description":"CreditWatch / outlook action word, if any.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].cwol_action_word.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].cwol_action_word","typeLabel":"string | null"},"cwol_ind":{"oneOf":[{"description":"CreditWatch / outlook indicator, if any.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cwol_ind.oneOf.0","typeLabel":"string"},{"description":"CreditWatch / outlook indicator, if any.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].cwol_ind.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].cwol_ind","typeLabel":"string | null"},"is_deleted":{"description":"Whether S\u0026P deleted this action. Deleted actions are only returned with `updated_since`, so an incremental pull can drop them.","nullable":false,"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].is_deleted","typeLabel":"boolean"},"isin":{"oneOf":[{"description":"US ISIN computed from the rating's CUSIP. `null` when the CUSIP is missing or not 9 characters.","example":"US1966324Q32","maxLength":12,"minLength":12,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].isin.oneOf.0","typeLabel":"string"},{"description":"US ISIN computed from the rating's CUSIP. `null` when the CUSIP is missing or not 9 characters.","example":"US1966324Q32","maxLength":12,"minLength":12,"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].isin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].isin","typeLabel":"string | null"},"maturity_date":{"oneOf":[{"description":"Maturity date of the rated instrument, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].maturity_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Maturity date of the rated instrument, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].maturity_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].maturity_date","typeLabel":"string\u003cdate-time> | null"},"org_debt_type_code":{"oneOf":[{"description":"S\u0026P organization debt-type code.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].org_debt_type_code.oneOf.0","typeLabel":"string"},{"description":"S\u0026P organization debt-type code.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].org_debt_type_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].org_debt_type_code","typeLabel":"string | null"},"outlook":{"oneOf":[{"description":"Outlook at the time of the action.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].outlook.oneOf.0","typeLabel":"string"},{"description":"Outlook at the time of the action.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].outlook.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].outlook","typeLabel":"string | null"},"outlook_date":{"oneOf":[{"description":"Datetime the outlook was set, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].outlook_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Datetime the outlook was set, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].outlook_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].outlook_date","typeLabel":"string\u003cdate-time> | null"},"prior_creditwatch":{"oneOf":[{"description":"CreditWatch status before this action.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].prior_creditwatch.oneOf.0","typeLabel":"string"},{"description":"CreditWatch status before this action.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].prior_creditwatch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].prior_creditwatch","typeLabel":"string | null"},"prior_outlook":{"oneOf":[{"description":"Outlook before this action.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].prior_outlook.oneOf.0","typeLabel":"string"},{"description":"Outlook before this action.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].prior_outlook.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].prior_outlook","typeLabel":"string | null"},"prior_rating_symbol":{"oneOf":[{"description":"Rating symbol before this action.","example":"A+","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].prior_rating_symbol.oneOf.0","typeLabel":"string"},{"description":"Rating symbol before this action.","example":"A+","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].prior_rating_symbol.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].prior_rating_symbol","typeLabel":"string | null"},"rating_action_word":{"oneOf":[{"description":"Action taken, e.g. `Upgrade`, `Downgrade`, `Affirmed`.","example":"Upgrade","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_action_word.oneOf.0","typeLabel":"string"},{"description":"Action taken, e.g. `Upgrade`, `Downgrade`, `Affirmed`.","example":"Upgrade","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_action_word.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_action_word","typeLabel":"string | null"},"rating_date":{"description":"Datetime of the rating action, in UTC. This is a datetime and not a date because that is how S\u0026P reports it.","format":"date-time","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_date","typeLabel":"string\u003cdate-time>"},"rating_detail_id":{"description":"S\u0026P rating-detail identifier. Stable across updates to this action.","example":12345,"nullable":false,"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_detail_id","typeLabel":"integer"},"rating_qualifier":{"oneOf":[{"description":"S\u0026P rating qualifier, if any.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_qualifier.oneOf.0","typeLabel":"string"},{"description":"S\u0026P rating qualifier, if any.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_qualifier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_qualifier","typeLabel":"string | null"},"rating_symbol":{"oneOf":[{"description":"S\u0026P rating symbol as reported on the action.","example":"AA-","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_symbol.oneOf.0","typeLabel":"string"},{"description":"S\u0026P rating symbol as reported on the action.","example":"AA-","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_symbol.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_symbol","typeLabel":"string | null"},"rating_type_code":{"oneOf":[{"description":"S\u0026P rating line, e.g. `STDLONG` (long-term), `STDSHORT` (short-term), `SPUR` (underlying).","example":"STDLONG","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_code.oneOf.0","typeLabel":"string"},{"description":"S\u0026P rating line, e.g. `STDLONG` (long-term), `STDSHORT` (short-term), `SPUR` (underlying).","example":"STDLONG","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_code","typeLabel":"string | null"},"regulatory_indicator":{"oneOf":[{"description":"S\u0026P regulatory indicator, if any.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].regulatory_indicator.oneOf.0","typeLabel":"string"},{"description":"S\u0026P regulatory indicator, if any.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].regulatory_indicator.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].regulatory_indicator","typeLabel":"string | null"},"regulatory_qualifier":{"oneOf":[{"description":"S\u0026P regulatory qualifier, if any.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].regulatory_qualifier.oneOf.0","typeLabel":"string"},{"description":"S\u0026P regulatory qualifier, if any.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].regulatory_qualifier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].regulatory_qualifier","typeLabel":"string | null"},"updated_at":{"description":"When Terrapin last added or changed this rating, in UTC. `updated_since` filters on this.","format":"date-time","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"}},"required":["creditwatch","creditwatch_date","current_rating_symbol","cusip","cwol_action_word","cwol_ind","is_deleted","isin","maturity_date","org_debt_type_code","outlook","outlook_date","prior_creditwatch","prior_outlook","prior_rating_symbol","rating_action_word","rating_date","rating_detail_id","rating_qualifier","rating_symbol","rating_type_code","regulatory_indicator","regulatory_qualifier","updated_at"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"next_cursor":{"oneOf":[{"description":"Send as `cursor` to get the next page. `null` on the last page, or when `limit` is 0.","type":"string","isRequired":true,"uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"description":"Send as `cursor` to get the next page. `null` on the last page, or when `limit` is 0.","type":"null","isRequired":true,"uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_cursor","typeLabel":"string | null"},"total":{"description":"Total number of results in the database that match the query filters.","type":"integer","isRequired":true,"uniqueKey":"total","typeLabel":"integer"}},"required":["data","next_cursor","total"],"title":"MuniRatingsSnpInstrumentsResponse","type":"object","uniqueKey":"","typeLabel":"MuniRatingsSnpInstrumentsResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":[{"creditwatch":null,"creditwatch_date":null,"current_rating_symbol":"AA-","cusip":"1966324Q3","cwol_action_word":null,"cwol_ind":null,"is_deleted":false,"isin":"US1966324Q32","maturity_date":"2035-02-01T00:00:00Z","org_debt_type_code":null,"outlook":"Stable","outlook_date":"2026-08-01T00:00:00Z","prior_creditwatch":null,"prior_outlook":"Positive","prior_rating_symbol":"A+","rating_action_word":"Upgrade","rating_date":"2026-08-01T00:00:00Z","rating_detail_id":12345,"rating_qualifier":null,"rating_symbol":"AA-","rating_type_code":"STDLONG","regulatory_indicator":null,"regulatory_qualifier":null,"updated_at":"2026-08-01T12:00:00Z"}],"next_cursor":null,"total":1}}},"exampleType":"examples"}},"description":"S\u0026P municipal instrument ratings","exampleType":"examples"},"887fbffd-697c-4138-b696-85173b8cd07a":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Unauthorized","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"example":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade.","type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Unauthorized","reason":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."}]}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"c7d9db85-7853-46d9-923a-58d0968e8414":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Payment Required","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"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","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Payment Required","reason":"You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade."}]}}},"exampleType":"generated"}},"description":"Payment Required","exampleType":"generated"},"c06efb02-4395-4811-b642-52b0751479ae":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Forbidden","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"example":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade.","type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Forbidden","reason":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."}]}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"52faf3a2-a180-4f40-a273-17e078478974":{"content":{"application/json":{"schema":{"properties":{"errors":{"items":{"properties":{"detail":{"example":"Invalid string. Got: integer","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"properties":{"pointer":{"example":"/isins/0","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"required":["pointer"],"type":"object","isRequired":true,"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"title":{"example":"Invalid value","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"}},"required":["detail","source","title"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Invalid string. Got: integer","source":{"pointer":"/isins/0"},"title":"Invalid value"}]}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"},"8b9c35d3-347e-456a-9ffb-2b424663a524":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Too Many Requests","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Too Many Requests","reason":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Too Many Requests","exampleType":"generated"},"5ec2a56e-e05c-44f4-acab-955f6333e15b":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Internal Server Error","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Internal Server Error","reason":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{"e12cca51-4bdd-4508-baae-7962af23d0d8":{"authorization":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"authorization"}}},"servers":{"1d267ed8-7ffc-4f6a-862e-b2d42318952c":{"url":"https://terrapinfinance.com","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"authorization"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"authorization","name":"Authorization"}],"title":"authorization"}]},"originalFileLocation":"openapi_spec.json"},"subdomain":"terrapinfinance","siteName":"Terrapin","title":"S\u0026P Instrument Ratings - Terrapin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:33:40.372Z","originalFileLocation":"api-endpoints/us-municipal-bond-ratings-snp-instruments.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Requires an existing license with S\u0026amp;P. Pass isins for the live ratings of those securities, updated_since for every rating added or changed since that UTC instant, or both. Ratings often arrive days after their rating_date, and updated_since still returns them. S\u0026amp;P deletes actions as well as issuing them. With updated_since, deleted actions are returned too, with is_deleted true, so an incremental pull can drop them.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Terrapin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"S\u0026amp;P Instrument Ratings - Terrapin\">\u003cmeta data-mint-head property=\"og:description\" content=\"Requires an existing license with S\u0026amp;P. Pass isins for the live ratings of those securities, updated_since for every rating added or changed since that UTC instant, or both. Ratings often arrive days after their rating_date, and updated_since still returns them. S\u0026amp;P deletes actions as well as issuing them. With updated_since, deleted actions are returned too, with is_deleted true, so an incremental pull can drop them.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Terrapin\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://terrapinfinance.com/images/og/documentation.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"S\u0026amp;P Instrument Ratings - Terrapin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Requires an existing license with S\u0026amp;P. Pass isins for the live ratings of those securities, updated_since for every rating added or changed since that UTC instant, or both. Ratings often arrive days after their rating_date, and updated_since still returns them. S\u0026amp;P deletes actions as well as issuing them. With updated_since, deleted actions are returned too, with is_deleted true, so an incremental pull can drop them.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://terrapinfinance.com/images/og/documentation.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Terrapin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5cc9c4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-endpoints/us-municipal-bond-ratings-snp-instruments.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.terrapinfinance.com/#organization\",\"name\":\"Terrapin\",\"url\":\"https://docs.terrapinfinance.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/logo.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=259202f1a61642e74e1194ad39a9e024\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.terrapinfinance.com#website\",\"name\":\"Terrapin\",\"url\":\"https://docs.terrapinfinance.com\",\"publisher\":{\"@id\":\"https://docs.terrapinfinance.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments#webpage\",\"url\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments\",\"name\":\"S\u0026P Instrument Ratings\",\"description\":\"Requires an existing license with S\u0026P. Pass isins for the live ratings of those securities, updated_since for every rating added or changed since that UTC instant, or both. Ratings often arrive days after their rating_date, and updated_since still returns them. S\u0026P deletes actions as well as issuing them. With updated_since, deleted actions are returned too, with is_deleted true, so an incremental pull can drop them.\",\"dateModified\":\"2026-11-17T10:33:40.372Z\",\"isPartOf\":{\"@id\":\"https://docs.terrapinfinance.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"US municipal securities\",\"item\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"S\u0026P Instrument Ratings\",\"item\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments#apireference\",\"headline\":\"S\u0026P Instrument Ratings\",\"name\":\"S\u0026P Instrument Ratings\",\"description\":\"Requires an existing license with S\u0026P. Pass isins for the live ratings of those securities, updated_since for every rating added or changed since that UTC instant, or both. Ratings often arrive days after their rating_date, and updated_since still returns them. S\u0026P deletes actions as well as issuing them. With updated_since, deleted actions are returned too, with is_deleted true, so an incremental pull can drop them.\",\"url\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments\",\"mainEntityOfPage\":{\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-snp-instruments#webpage\"},\"image\":\"https://terrapinfinance.com/images/og/documentation.png\",\"dateModified\":\"2026-11-17T10:33:40.372Z\",\"publisher\":{\"@id\":\"https://docs.terrapinfinance.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.terrapinfinance.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Terrapin\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Terrapin\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-endpoints/us-municipal-bond-ratings-snp-instruments.md","siteName":"Terrapin","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Getting started","pages":[{"title":"Welcome to Terrapin","mode":"wide","href":"/introduction"},{"title":"Authentication","mode":"wide","href":"/authentication"},{"title":"Rate limits \u0026 quotas","mode":"wide","href":"/rate-limits-and-quotas"},{"title":"Pagination","mode":"wide","href":"/pagination"},{"title":"Errors","mode":"wide","href":"/errors"}]},{"group":"Data dictionaries","pages":[{"title":"Fixed income securities","mode":"wide","href":"/data_dictionary_securities"},{"title":"US municipal securities","mode":"wide","href":"/data_dictionary_munis"},{"title":"US agency bonds","mode":"wide","href":"/data_dictionary_agencies"},{"title":"Government \u0026 corporate bonds","mode":"wide","href":"/data_dictionary_govies_corps"}]},{"group":"Other concepts","pages":[{"title":"Inflation factors","mode":"wide","href":"/inflation_factors"},{"title":"Use of Funds Taxonomy","mode":"wide","href":"/use_of_funds_taxonomy"}]},{"group":"Fixed income securities","pages":[{"title":"Bond Search","openapi":"post /api/v1/securities_search","href":"/api-endpoints/securities-search"},{"title":"Reference Data","openapi":"post /api/v1/securities_reference","href":"/api-endpoints/securities-reference"},{"title":"Latest Pricing","openapi":"post /api/v1/securities_pricing_latest","href":"/api-endpoints/securities-pricing-latest"},{"title":"Historical Pricing","openapi":"post /api/v1/securities_pricing_history","href":"/api-endpoints/securities-pricing-history"},{"title":"Cash Flows","openapi":"post /api/v1/securities_cashflows","href":"/api-endpoints/securities-cashflows"}]},{"group":"US municipal securities","pages":[{"title":"Bond Search","openapi":"post /api/v1/muni_search","href":"/api-endpoints/us-municipal-bond-search"},{"title":"Entity Search","openapi":"post /api/v1/muni_entity_search","href":"/api-endpoints/us-municipal-bond-entity-search"},{"title":"Reference Data","openapi":"post /api/v1/muni_reference","href":"/api-endpoints/us-municipal-bond-reference"},{"title":"Documents","openapi":"post /api/v1/muni_documents","href":"/api-endpoints/us-municipal-bond-documents"},{"title":"Latest Pricing","openapi":"post /api/v1/muni_pricing_latest","href":"/api-endpoints/us-municipal-bond-latest-pricing-data"},{"title":"Historical Pricing","openapi":"post /api/v1/muni_pricing_history","href":"/api-endpoints/us-municipal-bond-historical-pricing-data"},{"title":"Bulk Pricing","openapi":"post /api/v1/muni_pricing_daily_history","tag":"REST-only","href":"/api-endpoints/us-municipal-bond-daily-historical-pricing-data"},{"title":"Price To Yield","openapi":"post /api/v1/muni_price_to_yield","href":"/api-endpoints/us-municipal-bond-price-to-yield"},{"title":"Cash Flows","openapi":"post /api/v1/muni_cashflows","href":"/api-endpoints/us-municipal-bond-cashflows"},{"title":"Bonds in Series","openapi":"post /api/v1/muni_bonds_in_series","href":"/api-endpoints/us-municipal-bond-bonds-in-series"},{"title":"Event History","openapi":"post /api/v1/muni_events","description":"Get US municipal bond event history for given ISINs. Deprecated: the same events are returned by `/api/v1/muni_reference` as its `event_*` fields. This endpoint will be maintained and available until February 1, 2027.","href":"/api-endpoints/us-municipal-bond-events"},{"title":"S\u0026P Instrument Ratings","openapi":"post /api/v1/muni_ratings_snp_instruments","href":"/api-endpoints/us-municipal-bond-ratings-snp-instruments"},{"title":"Moody's Instrument Ratings","openapi":"post /api/v1/muni_ratings_moodys_instruments","description":"Requires an existing license with Moody's.\n\nEvery rating action Moody's published on a municipal security. Pass `isins`\nfor the ratings of those securities, `updated_since` for every rating added\nor changed since that UTC instant, or both. Ratings often arrive days after\ntheir `rating_date`, and `updated_since` still returns them.\n\nMoody's deletes rating records as well as publishing them. With\n`updated_since`, deleted records are returned too, with `is_deleted` true,\nso an incremental pull can drop them.\n\nMoody's can leave a superseded action unterminated next to its successor, so\na security's current rating in a rating class is its newest action there\nwithout a `rating_termination_date`. The issuer and obligor ratings are under\n`muni_ratings_moodys_orgs`, by `issuer_organization_id` and\n`obligor_organization_id`.\n","href":"/api-endpoints/us-municipal-bond-ratings-moodys-instruments"},{"title":"Moody's Organization Ratings","openapi":"post /api/v1/muni_ratings_moodys_orgs","href":"/api-endpoints/us-municipal-bond-ratings-moodys-orgs"}]},{"group":"US municipal bond statistics","pages":[{"title":"Outstanding Statistics","openapi":"post /api/v1/muni_stats_outstanding","href":"/api-endpoints/us-municipal-bond-stats-outstanding"},{"title":"Issuance Statistics","openapi":"post /api/v1/muni_stats_issuance","href":"/api-endpoints/us-municipal-bond-stats-issuance"},{"title":"Trade Activity Statistics","openapi":"post /api/v1/muni_stats_trade_activity","href":"/api-endpoints/us-municipal-bond-stats-trade-activity"},{"title":"Top Issuers","openapi":"post /api/v1/muni_stats_top_issuers","href":"/api-endpoints/us-municipal-bond-stats-top-issuers"}]},{"group":"Government Yield Curves","pages":[{"title":"Curve data","openapi":"post /api/v1/government_yield_curve","href":"/api-endpoints/government-yield-curve"}]},{"group":"Inflation Factors","pages":[{"title":"Inflation Factors","openapi":"post /api/v1/inflation_factors","href":"/api-endpoints/government-inflation-factors"}]},{"group":"US agency bonds (deprecated)","pages":[{"title":"Bond Search","openapi":"post /api/v1/agency_search","href":"/api-endpoints/us-agency-bond-search"},{"title":"Reference Data","openapi":"post /api/v1/agency_reference","href":"/api-endpoints/us-agency-bond-reference"},{"title":"Latest Pricing","openapi":"post /api/v1/agency_pricing_latest","href":"/api-endpoints/us-agency-latest-pricing-data"},{"title":"Historical Pricing","openapi":"post /api/v1/agency_pricing_history","href":"/api-endpoints/us-agency-historical-pricing-data"},{"title":"Cash Flows","openapi":"post /api/v1/agency_cashflows","href":"/api-endpoints/us-agency-cashflows"}]},{"group":"Government \u0026 corporate bonds (deprecated)","pages":[{"title":"Bond Search","openapi":"post /api/v1/bond_search","href":"/api-endpoints/government-and-corporate-bond-search"},{"title":"Reference Data","openapi":"post /api/v1/bond_reference","href":"/api-endpoints/government-and-corporate-reference-data"},{"title":"Latest Pricing","openapi":"post /api/v1/bond_pricing_latest","href":"/api-endpoints/government-and-corporate-latest-pricing-data"},{"title":"Historical Pricing","openapi":"post /api/v1/bond_pricing_history","href":"/api-endpoints/government-and-corporate-historical-pricing-data"},{"title":"Cash Flows","openapi":"post /api/v1/bond_cashflows","href":"/api-endpoints/government-and-corporate-cashflows"}]},{"group":"Utilities","pages":[{"title":"Convert CUSIPs to ISINs","openapi":"post /api/v1/convert_to_isin","href":"/api-endpoints/convert-to-isin"},{"title":"Download Document","openapi":"post /api/v1/download_document","href":"/api-endpoints/download-document"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/introduction"}]},{"tab":"Credit Intel Platform","pages":[{"title":"Credit Intel Platform","href":"/platform-guide/introduction"}]}]},"basePath":"","title":"S\u0026P Instrument Ratings - Terrapin","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}