> ## 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.

# Find products for filing preparation

> List products visible in scope mc:<MC UUID or stable slug>. Requires an ordinary user credential (readonly allowed), MC view access and the registered resource. Returns IDs usable in filing preparation. Filters combine with AND. These IDs are distinct from the shared research catalog at /products. Live name/ID ascending order; limit defaults to 50, maximum 100. Repeat scope, filters and limit with each cursor. Cursors expire two minutes after the first page. Continue through short or empty pages until nextCursor is null. Safe to repeat; creates nothing.



## OpenAPI

````yaml /openapi.json get /managed-filings/products
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/products:
    get:
      tags:
        - Managed Products
      summary: Find products for filing preparation
      description: >-
        List products visible in scope mc:<MC UUID or stable slug>. Requires an
        ordinary user credential (readonly allowed), MC view access and the
        registered resource. Returns IDs usable in filing preparation. Filters
        combine with AND. These IDs are distinct from the shared research
        catalog at /products. Live name/ID ascending order; limit defaults to
        50, maximum 100. Repeat scope, filters and limit with each cursor.
        Cursors expire two minutes after the first page. Continue through short
        or empty pages until nextCursor is null. Safe to repeat; creates
        nothing.
      operationId: listManagedProducts
      parameters:
        - schema:
            type: string
            pattern: ^mc:[A-Za-z0-9][A-Za-z0-9-]{0,127}$
            description: MC UUID or stable slug prefixed with mc:.
          required: true
          description: MC UUID or stable slug prefixed with mc:.
          name: scope
          in: query
        - 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
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Case-insensitive literal substring. Combine with other filters
              using AND.
          required: false
          description: >-
            Case-insensitive literal substring. Combine with other filters using
            AND.
          name: name
          in: query
      responses:
        '200':
          description: One page of products.
          content:
            application/json:
              schema:
                type: object
                properties:
                  products:
                    type: array
                    items:
                      $ref: '#/components/schemas/V2ManagedProduct'
                  nextCursor:
                    type: string
                    nullable: true
                    description: Cursor for the next page, or null on the last page.
                required:
                  - products
                  - nextCursor
        '400':
          description: >-
            Invalid request; restart the list after an invalid or 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: Scope, registered resource, or referenced jurisdiction not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '409':
          description: Resource already exists or conflicts with its references.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '413':
          description: Request body exceeds 64 KiB.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '415':
          description: Content-Type must be application/json.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '503':
          description: Temporarily unavailable. Honor Retry-After in seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2ManagedProduct:
      type: object
      properties:
        lifecycleStatus:
          type: string
        admitted:
          type: boolean
        description:
          type: string
          nullable: true
        name:
          type: string
        id:
          type: string
          format: uuid
      required:
        - lifecycleStatus
        - admitted
        - description
        - name
        - id
    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.