{
"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."
}
]
}
Every rating action Moody’s published on a municipal security. Pass isins
for the 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.
Moody’s deletes rating records as well as publishing them. With
updated_since, deleted records are returned too, with is_deleted true,
so an incremental pull can drop them.
Moody’s can leave a superseded action unterminated next to its successor, so
a security’s current rating in a rating class is its newest action there
without a rating_termination_date. The issuer and obligor ratings are under
muni_ratings_moodys_orgs, by issuer_organization_id and
obligor_organization_id.
{
"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:
-cusip,
-duration_code,
-duration_text,
-is_deleted,
-issuer_legal_name,
-issuer_organization_id,
-moodys_instrument_id,
-moodys_rating_id,
-obligor_legal_name,
-obligor_organization_id,
-rating_class_number,
-rating_class_text,
-rating_date,
-rating_direction_code,
-rating_direction_text,
-rating_termination_date,
-rating_text,
-rating_type_code,
-rating_type_text,
-seniority_code,
-seniority_text,
-shadow_code,
-shadow_text,
-updated_at,
-watchlist_date,
-watchlist_direction_code,
-watchlist_direction_text,
-watchlist_termination_date,
cusip,
duration_code,
duration_text,
is_deleted,
issuer_legal_name,
issuer_organization_id,
moodys_instrument_id,
moodys_rating_id,
obligor_legal_name,
obligor_organization_id,
rating_class_number,
rating_class_text,
rating_date,
rating_direction_code,
rating_direction_text,
rating_termination_date,
rating_text,
rating_type_code,
rating_type_text,
seniority_code,
seniority_text,
shadow_code,
shadow_text,
updated_at,
watchlist_date,
watchlist_direction_code,
watchlist_direction_text,
watchlist_termination_date
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 moodys_instrument_id, rating_class_number and
rating_date: some may be ratings you already have.
Response
Moody's 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-moodys-instruments","slug":"/api-endpoints/us-municipal-bond-ratings-moodys-instruments","pageMetadata":{"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"},"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 Moody’s.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Every rating action Moody’s published on a municipal security. Pass \", _jsx(_components.code, {\n children: \"isins\"\n }), \"\\nfor the ratings of those securities, \", _jsx(_components.code, {\n children: \"updated_since\"\n }), \" for every rating added\\nor changed since that UTC instant, or both. Ratings often arrive days after\\ntheir \", _jsx(_components.code, {\n children: \"rating_date\"\n }), \", and \", _jsx(_components.code, {\n children: \"updated_since\"\n }), \" still returns them.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Moody’s deletes rating records as well as publishing them. With\\n\", _jsx(_components.code, {\n children: \"updated_since\"\n }), \", deleted records are returned too, with \", _jsx(_components.code, {\n children: \"is_deleted\"\n }), \" true,\\nso an incremental pull can drop them.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Moody’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 \", _jsx(_components.code, {\n children: \"rating_termination_date\"\n }), \". The issuer and obligor ratings are under\\n\", _jsx(_components.code, {\n children: \"muni_ratings_moodys_orgs\"\n }), \", by \", _jsx(_components.code, {\n children: \"issuer_organization_id\"\n }), \" and\\n\", _jsx(_components.code, {\n children: \"obligor_organization_id\"\n }), \".\"]\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 Moody’s.`})})}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":"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"callbacks":{},"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","operationId":"post_muni_ratings_moodys_instruments","parameters":[],"requestBody":"a09d84c4-4330-4a28-b90d-0af80049566a","responses":{"200":"bfbd9b3a-0170-47a2-9e08-185c0f255be9","401":"72bb0c1c-475e-46f4-9ff5-17e616751585","402":"b71c7324-0dd0-4c42-a165-37b957e124cc","403":"a96ca007-5b07-49de-b03a-fe16937dca5f","422":"eb86b393-f322-4562-ab36-5b4a22fcd98d","429":"84d6b789-795b-460a-a8b6-65370275f816","500":"7e0fe5f3-9da3-418a-a1bf-a671951595c6"},"summary":"Moody's 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_moodys_instruments","baseUrlOptions":["https://terrapinfinance.com"],"title":"Moody's 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":["-cusip","-duration_code","-duration_text","-is_deleted","-issuer_legal_name","-issuer_organization_id","-moodys_instrument_id","-moodys_rating_id","-obligor_legal_name","-obligor_organization_id","-rating_class_number","-rating_class_text","-rating_date","-rating_direction_code","-rating_direction_text","-rating_termination_date","-rating_text","-rating_type_code","-rating_type_text","-seniority_code","-seniority_text","-shadow_code","-shadow_text","-updated_at","-watchlist_date","-watchlist_direction_code","-watchlist_direction_text","-watchlist_termination_date","cusip","duration_code","duration_text","is_deleted","issuer_legal_name","issuer_organization_id","moodys_instrument_id","moodys_rating_id","obligor_legal_name","obligor_organization_id","rating_class_number","rating_class_text","rating_date","rating_direction_code","rating_direction_text","rating_termination_date","rating_text","rating_type_code","rating_type_text","seniority_code","seniority_text","shadow_code","shadow_text","updated_at","watchlist_date","watchlist_direction_code","watchlist_direction_text","watchlist_termination_date"],"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 `moodys_instrument_id`, `rating_class_number` and\n`rating_date`: 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":{"bfbd9b3a-0170-47a2-9e08-185c0f255be9":{"content":{"application/json":{"example":{"data":[{"cusip":"1966324Q3","duration_code":"LT","duration_text":"Long Term Debt Rating","is_deleted":false,"isin":"US1966324Q32","issuer_legal_name":"CHARLESTON (CITY OF) SC","issuer_organization_id":"600012345","moodys_instrument_id":"987654321","moodys_rating_id":"123456789","obligor_legal_name":"CHARLESTON (CITY OF) SC","obligor_organization_id":"600012345","rating_class_number":"1","rating_class_text":"LT SR UNSECURED","rating_date":"2026-08-01T00:00:00Z","rating_direction_code":"UP","rating_direction_text":"Upgraded","rating_termination_date":null,"rating_text":"Aa2","rating_type_code":"LTD","rating_type_text":"Long-Term Debt Rating","seniority_code":"SR","seniority_text":"Senior Unsecured","shadow_code":"U","shadow_text":"Underlying","updated_at":"2026-08-01T12:00:00Z","watchlist_date":null,"watchlist_direction_code":null,"watchlist_direction_text":null,"watchlist_termination_date":null}],"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":{"cusip":{"description":"CUSIP of the rated municipal security.","example":"1966324Q3","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cusip","typeLabel":"string"},"duration_code":{"oneOf":[{"description":"Moody's duration code.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].duration_code.oneOf.0","typeLabel":"string"},{"description":"Moody's duration code.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].duration_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].duration_code","typeLabel":"string | null"},"duration_text":{"oneOf":[{"description":"Duration, e.g. `Long Term Debt Rating`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].duration_text.oneOf.0","typeLabel":"string"},{"description":"Duration, e.g. `Long Term Debt Rating`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].duration_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].duration_text","typeLabel":"string | null"},"is_deleted":{"description":"Whether Moody's deleted this record. Deleted records 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"},"issuer_legal_name":{"oneOf":[{"description":"The issuer's name as registered with Moody's.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_legal_name.oneOf.0","typeLabel":"string"},{"description":"The issuer's name as registered with Moody's.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_legal_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_legal_name","typeLabel":"string | null"},"issuer_organization_id":{"oneOf":[{"description":"Moody's identifier of the security's current issuer. Its ratings are under `muni_ratings_moodys_orgs`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_organization_id.oneOf.0","typeLabel":"string"},{"description":"Moody's identifier of the security's current issuer. Its ratings are under `muni_ratings_moodys_orgs`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_organization_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_organization_id","typeLabel":"string | null"},"moodys_instrument_id":{"description":"Moody's identifier for the rated security.","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].moodys_instrument_id","typeLabel":"string"},"moodys_rating_id":{"description":"Moody's identifier for this rating record. Stable across updates.","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].moodys_rating_id","typeLabel":"string"},"obligor_legal_name":{"oneOf":[{"description":"The obligor's name as registered with Moody's.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].obligor_legal_name.oneOf.0","typeLabel":"string"},{"description":"The obligor's name as registered with Moody's.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].obligor_legal_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].obligor_legal_name","typeLabel":"string | null"},"obligor_organization_id":{"oneOf":[{"description":"Moody's identifier of the security's current obligor. Its ratings are under `muni_ratings_moodys_orgs`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].obligor_organization_id.oneOf.0","typeLabel":"string"},{"description":"Moody's identifier of the security's current obligor. Its ratings are under `muni_ratings_moodys_orgs`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].obligor_organization_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].obligor_organization_id","typeLabel":"string | null"},"rating_class_number":{"description":"Moody's numeric rating-class identifier.","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_class_number","typeLabel":"string"},"rating_class_text":{"oneOf":[{"description":"Rating class, e.g. `LT SR DEP UNDERLYING`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_class_text.oneOf.0","typeLabel":"string"},{"description":"Rating class, e.g. `LT SR DEP UNDERLYING`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_class_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_class_text","typeLabel":"string | null"},"rating_date":{"description":"Datetime of the last rating action, excluding confirmations, in UTC. This is a datetime and not a date because that is how Moody's reports it.","format":"date-time","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_date","typeLabel":"string\u003cdate-time>"},"rating_direction_code":{"oneOf":[{"description":"Direction of the most recent rating action.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_direction_code.oneOf.0","typeLabel":"string"},{"description":"Direction of the most recent rating action.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_direction_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_direction_code","typeLabel":"string | null"},"rating_direction_text":{"oneOf":[{"description":"Direction of the most recent rating action, e.g. `Upgraded`.","example":"Upgraded","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_direction_text.oneOf.0","typeLabel":"string"},{"description":"Direction of the most recent rating action, e.g. `Upgraded`.","example":"Upgraded","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_direction_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_direction_text","typeLabel":"string | null"},"rating_termination_date":{"oneOf":[{"description":"Datetime the rating action was terminated, in UTC. This is a datetime and not a date because that is how Moody's reports it. `null` if still current.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_termination_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Datetime the rating action was terminated, in UTC. This is a datetime and not a date because that is how Moody's reports it. `null` if still current.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_termination_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_termination_date","typeLabel":"string\u003cdate-time> | null"},"rating_text":{"description":"Moody's rating value, e.g. `Aa2`.","example":"Aa2","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_text","typeLabel":"string"},"rating_type_code":{"oneOf":[{"description":"Moody's rating-type code.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_code.oneOf.0","typeLabel":"string"},{"description":"Moody's rating-type code.","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"},"rating_type_text":{"oneOf":[{"description":"Type of rating, e.g. `Long-Term Debt Rating`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_text.oneOf.0","typeLabel":"string"},{"description":"Type of rating, e.g. `Long-Term Debt Rating`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_type_text","typeLabel":"string | null"},"seniority_code":{"oneOf":[{"description":"Moody's seniority code.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].seniority_code.oneOf.0","typeLabel":"string"},{"description":"Moody's seniority code.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].seniority_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].seniority_code","typeLabel":"string | null"},"seniority_text":{"oneOf":[{"description":"Seniority, e.g. `Senior Secured`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].seniority_text.oneOf.0","typeLabel":"string"},{"description":"Seniority, e.g. `Senior Secured`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].seniority_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].seniority_text","typeLabel":"string | null"},"shadow_code":{"oneOf":[{"description":"Moody's shadow code: insured, enhanced, or underlying.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].shadow_code.oneOf.0","typeLabel":"string"},{"description":"Moody's shadow code: insured, enhanced, or underlying.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].shadow_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].shadow_code","typeLabel":"string | null"},"shadow_text":{"oneOf":[{"description":"Rating perspective, e.g. `Underlying`, `Insured`, `Enhanced`.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].shadow_text.oneOf.0","typeLabel":"string"},{"description":"Rating perspective, e.g. `Underlying`, `Insured`, `Enhanced`.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].shadow_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].shadow_text","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>"},"watchlist_date":{"oneOf":[{"description":"Datetime the rating was placed on Moody's watchlist, in UTC. `null` if it never was. A superseded action keeps the watchlist state it had.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Datetime the rating was placed on Moody's watchlist, in UTC. `null` if it never was. A superseded action keeps the watchlist state it had.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_date","typeLabel":"string\u003cdate-time> | null"},"watchlist_direction_code":{"oneOf":[{"description":"Moody's code for the watchlist direction.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_direction_code.oneOf.0","typeLabel":"string"},{"description":"Moody's code for the watchlist direction.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_direction_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_direction_code","typeLabel":"string | null"},"watchlist_direction_text":{"oneOf":[{"description":"Watchlist direction, e.g. `Possible Downgrade`, `Direction Uncertain`.","example":"Possible Downgrade","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_direction_text.oneOf.0","typeLabel":"string"},{"description":"Watchlist direction, e.g. `Possible Downgrade`, `Direction Uncertain`.","example":"Possible Downgrade","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_direction_text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_direction_text","typeLabel":"string | null"},"watchlist_termination_date":{"oneOf":[{"description":"Datetime the rating came off the watchlist, in UTC. `null` while it is on it.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_termination_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Datetime the rating came off the watchlist, in UTC. `null` while it is on it.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_termination_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].watchlist_termination_date","typeLabel":"string\u003cdate-time> | null"}},"required":["cusip","duration_code","duration_text","is_deleted","isin","issuer_legal_name","issuer_organization_id","moodys_instrument_id","moodys_rating_id","obligor_legal_name","obligor_organization_id","rating_class_number","rating_class_text","rating_date","rating_direction_code","rating_direction_text","rating_termination_date","rating_text","rating_type_code","rating_type_text","seniority_code","seniority_text","shadow_code","shadow_text","updated_at","watchlist_date","watchlist_direction_code","watchlist_direction_text","watchlist_termination_date"],"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":"MuniRatingsMoodysInstrumentsResponse","type":"object","uniqueKey":"","typeLabel":"MuniRatingsMoodysInstrumentsResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":[{"cusip":"1966324Q3","duration_code":"LT","duration_text":"Long Term Debt Rating","is_deleted":false,"isin":"US1966324Q32","issuer_legal_name":"CHARLESTON (CITY OF) SC","issuer_organization_id":"600012345","moodys_instrument_id":"987654321","moodys_rating_id":"123456789","obligor_legal_name":"CHARLESTON (CITY OF) SC","obligor_organization_id":"600012345","rating_class_number":"1","rating_class_text":"LT SR UNSECURED","rating_date":"2026-08-01T00:00:00Z","rating_direction_code":"UP","rating_direction_text":"Upgraded","rating_termination_date":null,"rating_text":"Aa2","rating_type_code":"LTD","rating_type_text":"Long-Term Debt Rating","seniority_code":"SR","seniority_text":"Senior Unsecured","shadow_code":"U","shadow_text":"Underlying","updated_at":"2026-08-01T12:00:00Z","watchlist_date":null,"watchlist_direction_code":null,"watchlist_direction_text":null,"watchlist_termination_date":null}],"next_cursor":null,"total":1}}},"exampleType":"examples"}},"description":"Moody's municipal instrument ratings","exampleType":"examples"},"72bb0c1c-475e-46f4-9ff5-17e616751585":{"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"},"b71c7324-0dd0-4c42-a165-37b957e124cc":{"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"},"a96ca007-5b07-49de-b03a-fe16937dca5f":{"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"},"eb86b393-f322-4562-ab36-5b4a22fcd98d":{"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"},"84d6b789-795b-460a-a8b6-65370275f816":{"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"},"7e0fe5f3-9da3-418a-a1bf-a671951595c6":{"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":"Moody's Instrument Ratings - Terrapin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:33:40.372Z","originalFileLocation":"api-endpoints/us-municipal-bond-ratings-moodys-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 Moody\u0026#x27;s. Every rating action Moody\u0026#x27;s published on a municipal security. Pass isins for the 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. Moody\u0026#x27;s deletes rating records as well as publishing them. With updated_since, deleted records are returned too, with is_deleted true, so an incremental pull can drop them. Moody\u0026#x27;s can leave a superseded action unterminated next to its successor, so a security\u0026#x27;s current rating in a rating class is its newest action there without a rating_termination_date. The issuer and obligor ratings are under muni_ratings_moodys_orgs, by issuer_organization_id and obligor_organization_id.\">\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=\"Moody\u0026#x27;s Instrument Ratings - Terrapin\">\u003cmeta data-mint-head property=\"og:description\" content=\"Requires an existing license with Moody\u0026#x27;s. Every rating action Moody\u0026#x27;s published on a municipal security. Pass isins for the 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. Moody\u0026#x27;s deletes rating records as well as publishing them. With updated_since, deleted records are returned too, with is_deleted true, so an incremental pull can drop them. Moody\u0026#x27;s can leave a superseded action unterminated next to its successor, so a security\u0026#x27;s current rating in a rating class is its newest action there without a rating_termination_date. The issuer and obligor ratings are under muni_ratings_moodys_orgs, by issuer_organization_id and obligor_organization_id.\">\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-moodys-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=\"Moody\u0026#x27;s Instrument Ratings - Terrapin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Requires an existing license with Moody\u0026#x27;s. Every rating action Moody\u0026#x27;s published on a municipal security. Pass isins for the 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. Moody\u0026#x27;s deletes rating records as well as publishing them. With updated_since, deleted records are returned too, with is_deleted true, so an incremental pull can drop them. Moody\u0026#x27;s can leave a superseded action unterminated next to its successor, so a security\u0026#x27;s current rating in a rating class is its newest action there without a rating_termination_date. The issuer and obligor ratings are under muni_ratings_moodys_orgs, by issuer_organization_id and obligor_organization_id.\">\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-moodys-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-moodys-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-moodys-instruments#webpage\",\"url\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-moodys-instruments\",\"name\":\"Moody's Instrument Ratings\",\"description\":\"Requires an existing license with Moody's. Every rating action Moody's published on a municipal security. Pass isins for the 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. Moody's deletes rating records as well as publishing them. With updated_since, deleted records are returned too, with is_deleted true, so an incremental pull can drop them. Moody's can leave a superseded action unterminated next to its successor, so a security's current rating in a rating class is its newest action there without a rating_termination_date. The issuer and obligor ratings are under muni_ratings_moodys_orgs, by issuer_organization_id and obligor_organization_id.\",\"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-moodys-instruments#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-moodys-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\":\"Moody's Instrument Ratings\",\"item\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-moodys-instruments\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-moodys-instruments#apireference\",\"headline\":\"Moody's Instrument Ratings\",\"name\":\"Moody's Instrument Ratings\",\"description\":\"Requires an existing license with Moody's. Every rating action Moody's published on a municipal security. Pass isins for the 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. Moody's deletes rating records as well as publishing them. With updated_since, deleted records are returned too, with is_deleted true, so an incremental pull can drop them. Moody's can leave a superseded action unterminated next to its successor, so a security's current rating in a rating class is its newest action there without a rating_termination_date. The issuer and obligor ratings are under muni_ratings_moodys_orgs, by issuer_organization_id and obligor_organization_id.\",\"url\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-moodys-instruments\",\"mainEntityOfPage\":{\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-ratings-moodys-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-moodys-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","href":"/api-endpoints/us-municipal-bond-events"},{"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"},{"title":"Moody's Instrument Ratings","openapi":"post /api/v1/muni_ratings_moodys_instruments","href":"/api-endpoints/us-municipal-bond-ratings-moodys-instruments"},{"title":"Moody's Organization Ratings","openapi":"post /api/v1/muni_ratings_moodys_orgs","description":"Requires an existing license with Moody's.\n\nEvery rating action Moody's published on a municipal organization (an\nissuer or obligor), outlooks included. Pass `moodys_organization_ids` for\nthe ratings of those organizations, `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\nAn outlook is a rating record of its own, with `rating_class_text`\n`Outlook`, and applies to the organization, not to one of its debt ratings.\nMoody's can leave a superseded action unterminated next to its successor, so\nan organization's current rating in a rating class, or its current outlook,\nis its newest action there without a `rating_termination_date`.\n","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":"Moody's 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"]}