> ## 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 rating programs > List rating programs in Effective’s shared library, including programs your organization has not subscribed to. Authentication is required. Filter by name, product, carrier, state, or subscription status. Results match all supplied filters. - **State:** Returns programs explicitly associated with that state. Omit this filter to include all geographic scopes. An unspecified state does not mean nationwide availability. - **Subscription:** Set `subscribed=true` for your organization’s active subscriptions, or `false` for programs it has not subscribed to. Omit this filter to include both. Results are sorted by name, then ID. To get the next page, pass `nextCursor` as `cursor` and keep the same filters and `limit`. Cursors do not expire. A cursor from a different query or caller returns `invalid_cursor`. ## OpenAPI ````yaml /openapi.json get /insurance/rating-programs 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.effectiveai.app/api/v2 description: Production security: - bearerAuth: [] paths: /insurance/rating-programs: get: tags: - Rating programs summary: List rating programs description: >- List rating programs in Effective’s shared library, including programs your organization has not subscribed to. Authentication is required. Filter by name, product, carrier, state, or subscription status. Results match all supplied filters. - **State:** Returns programs explicitly associated with that state. Omit this filter to include all geographic scopes. An unspecified state does not mean nationwide availability. - **Subscription:** Set `subscribed=true` for your organization’s active subscriptions, or `false` for programs it has not subscribed to. Omit this filter to include both. Results are sorted by name, then ID. To get the next page, pass `nextCursor` as `cursor` and keep the same filters and `limit`. Cursors do not expire. A cursor from a different query or caller returns `invalid_cursor`. operationId: listRatingPrograms parameters: - schema: type: integer minimum: 1 maximum: 200 default: 50 description: Maximum number of items to return (1-200). required: false description: Maximum number of items to return (1-200). name: limit in: query - schema: type: string minLength: 1 maxLength: 8192 description: >- Opaque nextCursor from this operation. Repeat every other query parameter unchanged; a cursor from a different query returns invalid_cursor. required: false description: >- Opaque nextCursor from this operation. Repeat every other query parameter unchanged; a cursor from a different query returns invalid_cursor. name: cursor in: query - schema: type: string maxLength: 300 required: false name: name in: query - schema: type: string required: false name: productId in: query - schema: type: string pattern: ^[A-Z]{2}$ required: false name: state in: query - schema: type: string required: false name: carrierId in: query - schema: type: string enum: - 'true' - 'false' required: false name: subscribed in: query responses: '200': description: One page of programs with current caller access. content: application/json: schema: type: object properties: programs: type: array items: $ref: '#/components/schemas/V2RatingProgramSummary' nextCursor: type: string nullable: true description: Cursor for the next page, or null on the last page. required: - programs - nextCursor additionalProperties: false '400': description: Invalid request or cursor. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '401': description: Authentication required. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '403': description: Program entitlement and user permission are required. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '404': description: Program, version or package not found. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '409': description: Stored bundle identity differs. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '413': description: Input exceeds the size limit. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '422': description: Invalid inputs or business refusal. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '429': description: Rating capacity unavailable; honor Retry-After. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '500': description: Unexpected failure. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '503': description: Dependency unavailable. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' security: - bearerAuth: [] components: schemas: V2RatingProgramSummary: type: object properties: name: type: string minLength: 1 maxLength: 300 description: type: string nullable: true maxLength: 4000 productId: type: string nullable: true state: type: string nullable: true pattern: ^[A-Z]{2}$ carrierId: type: string nullable: true id: type: string pattern: ^[a-z0-9][a-z0-9._-]{0,127}$ productName: type: string nullable: true carrierName: type: string nullable: true latestVersion: type: integer nullable: true minimum: 0 exclusiveMinimum: true access: type: object properties: canRun: type: boolean canDownload: type: boolean expiresAt: type: string nullable: true format: date-time required: - canRun - canDownload - expiresAt additionalProperties: false subscription: type: object properties: subscribed: type: boolean subscribedAt: type: string nullable: true format: date-time subscribedBy: type: string nullable: true canSubscribe: type: boolean canUnsubscribe: type: boolean required: - subscribed - subscribedAt - subscribedBy - canSubscribe - canUnsubscribe additionalProperties: false required: - name - description - productId - state - carrierId - id - productName - carrierName - latestVersion - access - subscription 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 - osha description: Dataset needed for dataset_not_enabled. accessUrl: type: string nullable: true format: uri description: >- Where to add the product to your account, for product_access_required. 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.