---
title: "Check CLO feed freshness"
url: "https://console.9fin.com/apis/clo-api/versions/221fee01-d90e-4b49-9e39-50dbcbf0d81c/operations/get_feed_summary_v0_clo_feed_summary_get"
---

> Full API specification: https://console.9fin.com/apis/clo-api/versions/221fee01-d90e-4b49-9e39-50dbcbf0d81c.md

# Check CLO feed freshness

`GET` `/v0/clo/feed-summary`

Operation ID: `get_feed_summary_v0_clo_feed_summary_get`

Return aggregate counts and freshness for the CLO feed.

## Query parameters

- `since` (optional) - When provided, the response includes changed_since counts for rows with updated_at >= since
- `until` (optional) - When provided with since, bounds changed_since to rows with updated_at <= until. Ignored without since.
- `status` (optional) - Filter deal status (default: Pre-Marketing, In market, Priced, and Called).
- `region` (optional) - Filter coverage region.

## Responses

- `200` - Successful Response
- `400` - Bad request (e.g. invalid cursor).
- `422` - Validation Error
- `500` - Unexpected server error.
- `503` - Service unavailable (e.g. database down).

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: 9fin CLO API
  version: 0.11.0
servers:
  - description: Production environment
    url: https://api.9fin.com
paths:
  /v0/clo/feed-summary:
    get:
      description: Return aggregate counts and freshness for the CLO feed.
      operationId: get_feed_summary_v0_clo_feed_summary_get
      parameters:
        - description: When provided, the response includes changed_since counts for rows
            with updated_at >= since
          in: query
          name: since
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: "null"
            default: null
            description: When provided, the response includes changed_since counts for rows
              with updated_at >= since
            title: Since
        - description: When provided with since, bounds changed_since to rows with
            updated_at <= until. Ignored without since.
          in: query
          name: until
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: "null"
            default: null
            description: When provided with since, bounds changed_since to rows with
              updated_at <= until. Ignored without since.
            title: Until
        - description: "Filter deal status (default: Pre-Marketing, In market, Priced, and
            Called)."
          in: query
          name: status
          required: false
          schema:
            anyOf:
              - enum:
                  - Pre-Marketing
                  - In market
                  - Priced
                  - Called
                  - all
                type: string
              - type: "null"
            default: null
            description: "Filter deal status (default: Pre-Marketing, In market, Priced, and
              Called)."
            title: Status
        - description: Filter coverage region.
          in: query
          name: region
          required: false
          schema:
            anyOf:
              - enum:
                  - US
                  - Europe
                  - LATAM
                  - APAC
                  - CEEMEA
                  - North America
                  - Western Europe
                type: string
              - type: "null"
            default: null
            description: Filter coverage region.
            title: Region
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FeedSummary"
          description: Successful Response
        "400":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
          description: Bad request (e.g. invalid cursor).
        "422":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HTTPValidationError"
          description: Validation Error
        "500":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/InternalServerErrorResponse"
          description: Unexpected server error.
        "503":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
          description: Service unavailable (e.g. database down).
      security:
        - HTTPBearer: []
      summary: Check CLO feed freshness
      tags:
        - Feed
security:
  - HTTPBearer: []
components:
  schemas:
    FeedSummary:
      description: Lightweight snapshot of in-market CLO feed freshness.
      properties:
        changed_since:
          anyOf:
            - $ref: "#/components/schemas/ChangedSince"
            - type: "null"
          description: Change counts since the since query param; null when since is
            omitted.
        clos:
          $ref: "#/components/schemas/ResourceSummary"
        tranches:
          $ref: "#/components/schemas/ResourceSummary"
      required:
        - clos
        - tranches
      title: FeedSummary
      type: object
    ErrorResponse:
      description: Client-facing error envelope.
      examples:
        - error_code: invalid_cursor
          message: The supplied cursor could not be decoded.
          trace_id: 202bde256c7d446f9623efdc96286c5d
        - error_code: service_unavailable
          message: Database is not available
          trace_id: c2416d52c6d14c8e831aad792407442c
      properties:
        error_code:
          title: Error Code
          type: string
        message:
          title: Message
          type: string
        trace_id:
          anyOf:
            - type: string
            - type: "null"
          title: Trace Id
      required:
        - error_code
        - message
      title: ErrorResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: "#/components/schemas/ValidationError"
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    InternalServerErrorResponse:
      properties:
        error_code:
          examples:
            - internal_server_error
          title: Error Code
          type: string
        message:
          examples:
            - An unexpected error occurred.
          title: Message
          type: string
        trace_id:
          anyOf:
            - type: string
            - type: "null"
          examples:
            - e7dfd20231374d308f04655eb0538be4
          title: Trace Id
      required:
        - error_code
        - message
      title: InternalServerErrorResponse
      type: object
    ChangedSince:
      description: Rows changed since the caller's watermark.
      properties:
        clos:
          description: CLO deal rows with updated_at >= since.
          title: Clos
          type: integer
        tranches:
          description: Tranche rows with updated_at >= since.
          title: Tranches
          type: integer
      required:
        - clos
        - tranches
      title: ChangedSince
      type: object
    ResourceSummary:
      description: Freshness snapshot for one in-market feed resource.
      properties:
        latest_updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: "null"
          description: Most recent updated_at timestamp across matching rows (UTC), if any.
          title: Latest Updated At
      title: ResourceSummary
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    HTTPBearer:
      bearerFormat: JWT
      scheme: bearer
      type: http
```