> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terrapinfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Moody's Organization Ratings

> Requires an existing license with Moody's.

Every rating action Moody's published on a municipal organization (an
issuer or obligor), outlooks included. Pass `moodys_organization_ids` for
the ratings of those organizations, `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.

An outlook is a rating record of its own, with `rating_class_text`
`Outlook`, and applies to the organization, not to one of its debt ratings.
Moody's can leave a superseded action unterminated next to its successor, so
an organization's current rating in a rating class, or its current outlook,
is its newest action there without a `rating_termination_date`.


> [!WARNING]
>
> Access requires an existing license with Moody's.


## OpenAPI

````yaml post /api/v1/muni_ratings_moodys_orgs
openapi: 3.0.0
info:
  title: Terrapin API
  version: 1.0.0
servers:
  - url: https://terrapinfinance.com
    variables: {}
security:
  - authorization: []
tags: []
paths:
  /api/v1/muni_ratings_moodys_orgs:
    post:
      tags: []
      summary: Moody's municipal organization ratings
      description: >
        Requires an existing license with Moody's.


        Every rating action Moody's published on a municipal organization (an

        issuer or obligor), outlooks included. Pass `moodys_organization_ids`
        for

        the ratings of those organizations, `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.


        An outlook is a rating record of its own, with `rating_class_text`

        `Outlook`, and applies to the organization, not to one of its debt
        ratings.

        Moody's can leave a superseded action unterminated next to its
        successor, so

        an organization's current rating in a rating class, or its current
        outlook,

        is its newest action there without a `rating_termination_date`.
      operationId: post_muni_ratings_moodys_orgs
      parameters: []
      requestBody:
        content:
          application/json:
            example:
              moodys_organization_ids:
                - '600025942'
              updated_since: '2026-08-01T00:00:00Z'
            schema:
              additionalProperties: false
              properties:
                cursor:
                  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).
                  nullable: true
                  type: 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
                moodys_organization_ids:
                  description: >
                    Moody's identifiers of the organizations to return ratings
                    for, as

                    `muni_ratings_moodys_instruments` gives them in
                    `issuer_organization_id`

                    and `obligor_organization_id`.
                  items:
                    example: '600025942'
                    nullable: false
                    type: string
                  type: array
                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:
                      - '-cik'
                      - '-county_name'
                      - '-credit_grade'
                      - '-cusip6s'
                      - '-duration_code'
                      - '-duration_text'
                      - '-evaluation_type_code'
                      - '-evaluation_type_text'
                      - '-is_deleted'
                      - '-lei'
                      - '-moodys_legal_name'
                      - '-moodys_organization_id'
                      - '-moodys_rating_id'
                      - '-rating_class_number'
                      - '-rating_class_text'
                      - '-rating_date'
                      - '-rating_direction_code'
                      - '-rating_direction_text'
                      - '-rating_rank'
                      - '-rating_termination_date'
                      - '-rating_text'
                      - '-rating_type_code'
                      - '-rating_type_text'
                      - '-security_class_code'
                      - '-security_class_text'
                      - '-security_description'
                      - '-seniority_code'
                      - '-seniority_text'
                      - '-shadow_code'
                      - '-shadow_text'
                      - '-state'
                      - '-updated_at'
                      - cik
                      - county_name
                      - credit_grade
                      - cusip6s
                      - duration_code
                      - duration_text
                      - evaluation_type_code
                      - evaluation_type_text
                      - is_deleted
                      - lei
                      - moodys_legal_name
                      - moodys_organization_id
                      - moodys_rating_id
                      - rating_class_number
                      - rating_class_text
                      - rating_date
                      - rating_direction_code
                      - rating_direction_text
                      - rating_rank
                      - rating_termination_date
                      - rating_text
                      - rating_type_code
                      - rating_type_text
                      - security_class_code
                      - security_class_text
                      - security_description
                      - seniority_code
                      - seniority_text
                      - shadow_code
                      - shadow_text
                      - state
                      - updated_at
                    type: string
                  type: array
                  x-transform: downcase
                updated_since:
                  description: >
                    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_organization_id`,
                    `rating_class_number`,

                    `rating_date` and `moodys_rating_id`: some may be ratings
                    you already have.
                  format: date-time
                  nullable: false
                  type: string
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  - cik: null
                    county_name: Hamilton (County of) OH
                    credit_grade: Investment Grade
                    cusip6s:
                      - '171196'
                      - '171198'
                    duration_code: '25636'
                    duration_text: Long-Term Debt Rating
                    evaluation_type_code: '25648'
                    evaluation_type_text: Credit Risk
                    is_deleted: false
                    lei: 5493006QYFB72E0IOO54
                    moodys_legal_name: CINCINNATI (CITY OF) OH
                    moodys_organization_id: '600025942'
                    moodys_rating_id: '-808473269'
                    rating_class_number: '-7'
                    rating_class_text: LT SR GO UNDERLYING
                    rating_date: '2026-10-29T16:38:10Z'
                    rating_direction_code: '12893'
                    rating_direction_text: AFFIRMATION
                    rating_rank: '3'
                    rating_termination_date: null
                    rating_text: Aa2
                    rating_type_code: '534'
                    rating_type_text: Long-Term Debt Rating
                    security_class_code: '786'
                    security_class_text: General Obligation
                    security_description: >-
                      Police and Fire Pension Refunding Unlimited Tax General
                      Obligation Bonds, Series 2005C
                    seniority_code: '697'
                    seniority_text: Senior
                    shadow_code: '2258'
                    shadow_text: Underlying
                    state: OH
                    updated_at: '2026-10-30T02:45: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:
                        cik:
                          description: SEC Central Index Key.
                          nullable: true
                          type: string
                        county_name:
                          description: >-
                            County of the organization. `null` when it isn't
                            tied to one.
                          nullable: true
                          type: string
                        credit_grade:
                          description: >-
                            `Investment Grade` or `Speculative Grade`. `null`
                            for outlooks.
                          nullable: true
                          type: string
                        cusip6s:
                          description: >-
                            The 6-character CUSIP issuer prefixes registered to
                            the organization. Broader than the prefixes of its
                            rated securities, since registration doesn't require
                            outstanding rated debt.
                          example:
                            - '171196'
                            - '171198'
                          items:
                            maxLength: 6
                            minLength: 6
                            type: string
                          nullable: true
                          type: array
                        duration_code:
                          description: Moody's duration code.
                          nullable: true
                          type: string
                        duration_text:
                          description: Duration, e.g. `Long-Term Debt Rating`.
                          nullable: true
                          type: string
                        evaluation_type_code:
                          description: Moody's code for what the rating evaluates.
                          nullable: true
                          type: string
                        evaluation_type_text:
                          description: >-
                            `Credit Risk` for debt ratings, `Ratings Outlook`
                            for outlooks.
                          nullable: true
                          type: string
                        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
                        lei:
                          description: Legal Entity Identifier.
                          nullable: true
                          type: string
                        moodys_legal_name:
                          description: The organization's name as registered with Moody's.
                          example: CINCINNATI (CITY OF) OH
                          nullable: true
                          type: string
                        moodys_organization_id:
                          description: Moody's identifier for the rated organization.
                          example: '600025942'
                          nullable: false
                          type: string
                        moodys_rating_id:
                          description: >-
                            Moody's identifier for this rating record. Stable
                            across updates.
                          nullable: false
                          type: string
                        rating_class_number:
                          description: Moody's numeric rating-class identifier.
                          nullable: false
                          type: string
                        rating_class_text:
                          description: >-
                            Rating class, e.g. `LT SR GO UNDERLYING`, or
                            `Outlook`.
                          nullable: true
                          type: string
                        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
                        rating_direction_code:
                          description: Direction of the most recent rating action.
                          nullable: true
                          type: string
                        rating_direction_text:
                          description: >-
                            Direction of the most recent rating action, e.g.
                            `AFFIRMATION`.
                          nullable: true
                          type: string
                        rating_rank:
                          description: >-
                            Rank of the rating within its scale, `1` being the
                            highest.
                          nullable: true
                          type: string
                        rating_termination_date:
                          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 not terminated.
                          format: date-time
                          nullable: true
                          type: string
                        rating_text:
                          description: >-
                            Moody's rating value, e.g. `Aa2`, or for an outlook
                            its value: `STA`, `NEG`, `POS`, `DEV`, `RWR`, `NOO`
                            (no outlook), or an `(m)` variant for multiple
                            outlooks.
                          example: Aa2
                          nullable: false
                          type: string
                        rating_type_code:
                          description: Moody's rating-type code.
                          nullable: true
                          type: string
                        rating_type_text:
                          description: >-
                            Type of rating, e.g. `Long-Term Debt Rating`,
                            `Rating Outlook`.
                          nullable: true
                          type: string
                        security_class_code:
                          description: >-
                            Moody's code for the security class the rating
                            applies to.
                          nullable: true
                          type: string
                        security_class_text:
                          description: >-
                            Security class, e.g. `General Obligation`, `Lease
                            Rental`.
                          nullable: true
                          type: string
                        security_description:
                          description: >-
                            Free-text description of the rated debt, e.g. a bond
                            series name.
                          nullable: true
                          type: string
                        seniority_code:
                          description: Moody's seniority code.
                          nullable: true
                          type: string
                        seniority_text:
                          description: Seniority, e.g. `Senior`.
                          nullable: true
                          type: string
                        shadow_code:
                          description: >-
                            Moody's shadow code: insured, enhanced, or
                            underlying.
                          nullable: true
                          type: string
                        shadow_text:
                          description: >-
                            Rating perspective, e.g. `Underlying`, `Insured`,
                            `Enhanced`.
                          nullable: true
                          type: string
                        state:
                          description: Two-letter US state of the organization.
                          example: OH
                          nullable: true
                          type: string
                        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
                      required:
                        - cik
                        - county_name
                        - credit_grade
                        - cusip6s
                        - duration_code
                        - duration_text
                        - evaluation_type_code
                        - evaluation_type_text
                        - is_deleted
                        - lei
                        - moodys_legal_name
                        - moodys_organization_id
                        - moodys_rating_id
                        - rating_class_number
                        - rating_class_text
                        - rating_date
                        - rating_direction_code
                        - rating_direction_text
                        - rating_rank
                        - rating_termination_date
                        - rating_text
                        - rating_type_code
                        - rating_type_text
                        - security_class_code
                        - security_class_text
                        - security_description
                        - seniority_code
                        - seniority_text
                        - shadow_code
                        - shadow_text
                        - state
                        - updated_at
                      type: object
                    type: array
                  next_cursor:
                    description: >-
                      Send as `cursor` to get the next page. `null` on the last
                      page, or when `limit` is 0.
                    nullable: true
                    type: string
                  total:
                    description: >-
                      Total number of results in the database that match the
                      query filters.
                    type: integer
                required:
                  - data
                  - next_cursor
                  - total
                title: MuniRatingsMoodysOrgsResponse
                type: object
          description: Moody's municipal organization ratings
        '401':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Unauthorized
                          type: string
                        reason:
                          example: >-
                            Your account tier does not allow this operation.
                            Contact team@terrapinfinance.com for an upgrade.
                          type: string
                      required:
                        - detail
                      type: object
                    type: array
                required:
                  - errors
                type: object
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Payment Required
                          type: 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
                      required:
                        - detail
                      type: object
                    type: array
                required:
                  - errors
                type: object
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Forbidden
                          type: string
                        reason:
                          example: >-
                            Your account tier does not allow this operation.
                            Contact team@terrapinfinance.com for an upgrade.
                          type: string
                      required:
                        - detail
                      type: object
                    type: array
                required:
                  - errors
                type: object
          description: Forbidden
        '422':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          example: 'Invalid string. Got: integer'
                          type: string
                        source:
                          properties:
                            pointer:
                              example: /isins/0
                              type: string
                          required:
                            - pointer
                          type: object
                        title:
                          example: Invalid value
                          type: string
                      required:
                        - detail
                        - source
                        - title
                      type: object
                    type: array
                required:
                  - errors
                type: object
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Too Many Requests
                          type: string
                        reason:
                          type: string
                      required:
                        - detail
                      type: object
                    type: array
                required:
                  - errors
                type: object
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Internal Server Error
                          type: string
                        reason:
                          type: string
                      required:
                        - detail
                      type: object
                    type: array
                required:
                  - errors
                type: object
          description: Internal Server Error
      callbacks: {}
components:
  securitySchemes:
    authorization:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.