> ## Documentation Index > Fetch the complete documentation index at: https://docs.effectiveai.app/llms.txt > Use this file to discover all available pages before exploring further. # List products > Find shared insurance products. Repeated filters use OR; distinct filters use AND. Carrier, state, TOI and SubTOI must match the same availability row. Each product appears once and includes complete availability. Offset-backed opaque cursors match carrier/MGA pagination: live results, no binding or expiry. Sort by case-insensitive name, then ID. Repeat filters and limit on subsequent pages. Unknown parameters and repeated scalars are rejected. Responses are private, no-store; missing availability is not proof of unavailability. ## OpenAPI ````yaml /openapi.json get /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://effectiveai.app/api/v2 description: Production security: - bearerAuth: [] paths: /products: get: tags: - Products summary: List products description: >- Find shared insurance products. Repeated filters use OR; distinct filters use AND. Carrier, state, TOI and SubTOI must match the same availability row. Each product appears once and includes complete availability. Offset-backed opaque cursors match carrier/MGA pagination: live results, no binding or expiry. Sort by case-insensitive name, then ID. Repeat filters and limit on subsequent pages. Unknown parameters and repeated scalars are rejected. Responses are private, no-store; missing availability is not proof of unavailability. operationId: listProducts parameters: - schema: type: string minLength: 1 maxLength: 200 description: Case-insensitive literal substring of the product name. example: Cyber required: false description: Case-insensitive literal substring of the product name. name: name in: query - schema: type: string minLength: 1 maxLength: 200 description: NAIC group code; leading zeros normalized. example: '7' required: false description: NAIC group code; leading zeros normalized. name: groupId in: query - schema: type: string minLength: 1 maxLength: 200 pattern: ^[a-z0-9]+(-[a-z0-9]+)*$ description: Existing directory MGA slug. example: cover required: false description: Existing directory MGA slug. name: mgaId in: query - schema: anyOf: - type: string minLength: 1 maxLength: 200 - type: array items: type: string minLength: 1 maxLength: 200 minItems: 1 maxItems: 100 description: Writing-company NAIC codes, normalized to five digits. example: - '00321' required: false description: Writing-company NAIC codes, normalized to five digits. name: carriers in: query - schema: anyOf: - type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ - type: array items: type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ minItems: 1 maxItems: 100 description: Exact, case-sensitive state text. example: - TX required: false description: Exact, case-sensitive state text. name: states in: query - schema: anyOf: - type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ - type: array items: type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ minItems: 1 maxItems: 100 description: Exact, case-sensitive Line of Business (open text). example: - cyber required: false description: Exact, case-sensitive Line of Business (open text). name: types in: query - schema: anyOf: - type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ - type: array items: type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ minItems: 1 maxItems: 100 description: Exact TOI codes, preserving leading zeros. example: - '05.0' required: false description: Exact TOI codes, preserving leading zeros. name: toiCodes in: query - schema: anyOf: - type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ - type: array items: type: string minLength: 1 maxLength: 200 pattern: ^[^,\[\]]+$ minItems: 1 maxItems: 100 description: >- Exact SubTOI codes, preserving leading zeros; usable without toiCodes. example: - '05.0002' required: false description: >- Exact SubTOI codes, preserving leading zeros; usable without toiCodes. name: subtoiCodes in: query - schema: type: string enum: - 'true' - 'false' description: Admission status; omit to include both. example: 'true' required: false description: Admission status; omit to include both. name: admitted in: query - schema: type: integer minimum: 1 maximum: 200 default: 50 description: Products per page; default 50, range 1–200. example: 50 required: false description: Products per page; default 50, range 1–200. name: limit in: query - schema: type: string description: Opaque nextCursor from the previous page; omit on the first page. example: eyJvZmZzZXQiOjUwfQ required: false description: Opaque nextCursor from the previous page; omit on the first page. name: cursor in: query responses: '200': description: One page of products; no exact total count. content: application/json: schema: type: object properties: products: type: array items: $ref: '#/components/schemas/V2Product' nextCursor: type: string nullable: true description: Cursor for the next page, or null on the last page. required: - products - nextCursor additionalProperties: false '400': description: >- Invalid request or invalid_cursor; restart the list for an invalid cursor. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '401': description: Missing or invalid credentials, or credential scope denied. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '403': description: The credential does not permit this operation. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '429': description: Rate limited. Honor Retry-After (seconds) when provided. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '500': description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '503': description: Dependency unavailable. Honor Retry-After (seconds). content: application/json: schema: $ref: '#/components/schemas/V2CodedError' security: - bearerAuth: [] components: schemas: V2Product: type: object properties: id: type: string description: Opaque canonical product_… ID. Use exactly as returned. name: type: string type: type: string description: Line of Business; open text. admitted: type: boolean predecessorProductId: type: string nullable: true note: type: string nullable: true group: type: object nullable: true properties: id: type: string name: type: string required: - id - name additionalProperties: false description: Configured group with its NAIC group code as id, or null. mga: type: object nullable: true properties: id: type: string name: type: string required: - id - name additionalProperties: false description: Configured MGA with its existing directory slug as id, or null. availability: type: array items: type: object properties: state: type: string writingCompanies: type: array items: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false description: >- IDs are five-digit NAIC codes. SERFF order: lead filer first, then co-filers. A missing carrier profile uses its NAIC code as its display name. toiCodes: type: array nullable: true items: type: string subtoiCodes: type: array nullable: true items: type: string note: type: string nullable: true required: - state - writingCompanies - toiCodes - subtoiCodes - note additionalProperties: false description: >- Complete configured availability, ordered by state, including rows not matching list filters. required: - id - name - type - admitted - predecessorProductId - note - group - mga - availability 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.