> ## 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 filing Records across Mission Controls

> Requires an ordinary user API key. Lists visible filing Records across all active MCs the caller can view in their tenant. No MC filter. Includes managed and reference Records, distinct from the regulatory catalog. Live order: MC UUID ascending, then createdAt descending and filing ID ascending. Limit defaults to 50, maximum 100. Cursors expire 24 hours after the first page; repeat limit. Access is rechecked on every page. Newly visible records before the cursor require restarting. Continue until nextCursor is null, including after a short or empty page. Performs no acquisition or workflow execution.



## OpenAPI

````yaml /openapi.json get /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://canary.effectiveai.app/api/v2
    description: Canary
security:
  - bearerAuth: []
paths:
  /managed-filings:
    get:
      tags:
        - Managed Filings
      summary: List accessible filing Records across Mission Controls
      description: >-
        Requires an ordinary user API key. Lists visible filing Records across
        all active MCs the caller can view in their tenant. No MC filter.
        Includes managed and reference Records, distinct from the regulatory
        catalog. Live order: MC UUID ascending, then createdAt descending and
        filing ID ascending. Limit defaults to 50, maximum 100. Cursors expire
        24 hours after the first page; repeat limit. Access is rechecked on
        every page. Newly visible records before the cursor require restarting.
        Continue until nextCursor is null, including after a short or empty
        page. Performs no acquisition or workflow execution.
      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 Mission Control 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: Filing Record ID; not a reference-catalog filing ID.
        scope:
          type: string
          pattern: ^mc:[0-9a-f-]{36}$
          description: 'Canonical authorization scope: mc:<MC UUID>.'
        displayName:
          type: string
        filingMode:
          type: string
          nullable: true
          enum:
            - managed
            - reference
            - null
          description: Null means unclassified legacy data; do not assume it is editable.
        companyId:
          type: string
          format: uuid
        jurisdictionId:
          type: string
          format: uuid
        primaryProductId:
          type: string
          format: uuid
        filingType:
          type: string
        description:
          type: string
          nullable: true
        serffTrackingNumber:
          type: string
          nullable: true
        stateTrackingNumber:
          type: string
          nullable: true
        companyTrackingNumber:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      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.
          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.