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

# List accessible filings

> List the workspace filings you can access across every available scope, including read-only reference filings. These are separate from the regulatory catalog at `/filings`. Before tenant sharing, order is scope UUID ascending, then createdAt descending and filing ID ascending. Shared filings appear once, ordered by createdAt descending and filing ID ascending. Limit defaults to 50, maximum 100. Pass nextCursor as cursor with the same limit; cursors expire 24 hours after the first page. Access is rechecked on every page. Restart if tenant-sharing mode changes or the selected scope loses access. Continue until nextCursor is null, including after a short or empty page.



## OpenAPI

````yaml /openapi.json get /insurance/managed-filings
openapi: 3.0.3
info:
  title: Effective API
  version: 2.0.0
  description: The public Effective REST API. Authenticate using an Effective API key.
servers:
  - url: https://api.canary.effectiveai.app/api/v2
    description: Canary
security:
  - bearerAuth: []
paths:
  /insurance/managed-filings:
    get:
      tags:
        - Managed Filings
      summary: List accessible filings
      description: >-
        List the workspace filings you can access across every available scope,
        including read-only reference filings. These are separate from the
        regulatory catalog at `/filings`. Before tenant sharing, order is scope
        UUID ascending, then createdAt descending and filing ID ascending.
        Shared filings appear once, ordered by createdAt descending and filing
        ID ascending. Limit defaults to 50, maximum 100. Pass nextCursor as
        cursor with the same limit; cursors expire 24 hours after the first
        page. Access is rechecked on every page. Restart if tenant-sharing mode
        changes or the selected scope loses access. Continue until nextCursor is
        null, including after a short or empty page.
      operationId: listManagedFilings
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          required: false
          name: limit
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 128
          required: false
          name: cursor
          in: query
      responses:
        '200':
          description: Accessible filing summaries.
          content:
            application/json:
              schema:
                type: object
                properties:
                  filings:
                    type: array
                    items:
                      $ref: '#/components/schemas/V2ManagedFiling'
                  nextCursor:
                    type: string
                    nullable: true
                    description: Cursor for the next page, or null on the last page.
                required:
                  - filings
                  - nextCursor
                additionalProperties: false
        '400':
          description: Invalid request or invalid/expired cursor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '403':
          description: Credential or scope access denied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '404':
          description: Resource missing or not visible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '503':
          description: Dependency temporarily unavailable. Respect Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2ManagedFiling:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Managed filing ID; not a reference-catalog filing ID.
        scope:
          type: string
          pattern: ^mc:[0-9a-f-]{36}$
          description: 'Canonical authorization scope: mc:<scope UUID>.'
        displayName:
          type: string
          description: >-
            Display label: the first available SERFF, state, or company tracking
            number, otherwise the filing ID.
        filingMode:
          type: string
          nullable: true
          enum:
            - reference
            - managed
            - null
          description: >-
            managed is a working filing; reference is a read-only imported
            filing. Null is unclassified legacy data and is also read-only.
        companyId:
          type: string
          format: uuid
          description: >-
            Company ID from GET or POST
            /api/v2/insurance/managed-filings/companies in this scope.
        jurisdictionId:
          type: string
          format: uuid
          description: >-
            Jurisdiction ID from GET or POST
            /api/v2/insurance/managed-filings/jurisdictions in this scope.
        primaryProductId:
          type: string
          format: uuid
          description: >-
            Product ID from GET or POST
            /api/v2/insurance/managed-filings/products in this scope.
        filingType:
          type: string
          description: >-
            Material or action being filed: form, rate, rule, their named
            combinations, adoption of existing material, or withdrawal of
            material.
        description:
          type: string
          nullable: true
          description: Free-text summary of the filing being prepared.
        serffTrackingNumber:
          type: string
          nullable: true
          description: Tracking number assigned by SERFF; null if not recorded.
        stateTrackingNumber:
          type: string
          nullable: true
          description: >-
            Tracking number assigned by the reviewing jurisdiction; null if not
            recorded.
        companyTrackingNumber:
          type: string
          nullable: true
          description: Your company’s internal tracking number; null if not recorded.
        createdAt:
          type: string
          format: date-time
          description: Time the filing workspace was created, in UTC.
        updatedAt:
          type: string
          format: date-time
          description: Time the filing details were last updated, in UTC.
      required:
        - id
        - scope
        - displayName
        - filingMode
        - companyId
        - jurisdictionId
        - primaryProductId
        - filingType
        - description
        - serffTrackingNumber
        - stateTrackingNumber
        - companyTrackingNumber
        - createdAt
        - updatedAt
      additionalProperties: false
    V2CodedError:
      allOf:
        - $ref: '#/components/schemas/V2Error'
        - type: object
          properties:
            code:
              type: string
              minLength: 1
              description: Stable error code. Clients must tolerate unknown future codes.
            details:
              type: array
              items:
                type: object
                properties:
                  location:
                    type: string
                    enum:
                      - path
                      - query
                      - header
                      - body
                  path:
                    type: array
                    items:
                      type: string
                      maxLength: 64
                    maxItems: 12
                  code:
                    type: string
                    enum:
                      - required
                      - invalid_type
                      - invalid_value
                      - unknown_field
                  message:
                    type: string
                    minLength: 1
                    maxLength: 200
                required:
                  - location
                  - path
                  - code
                  - message
              minItems: 1
              maxItems: 20
              description: Bounded safe validation issues; may omit some invalid fields.
            requestId:
              type: string
              minLength: 1
              maxLength: 128
              description: >-
                Existing server correlation for this HTTP attempt, when
                available.
            dataset:
              type: string
              enum:
                - naic
              description: Dataset needed for dataset_not_enabled.
          required:
            - code
    V2Error:
      type: object
      properties:
        error:
          type: string
          minLength: 1
          description: Human-readable explanation of the failure.
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Effective API key. Send Authorization: Bearer sk-eai-...'

````

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