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

> Search US P&C carriers by name, NAIC code or group, and filter by the states and lines they filed in SERFF in the last 12 months. Unknown query parameters and repeated scalar values are rejected. Responses are private, no-store.



## OpenAPI

````yaml /openapi.json get /carriers
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:
  /carriers:
    get:
      tags:
        - Carriers
      summary: List carriers
      description: >-
        Search US P&C carriers by name, NAIC code or group, and filter by the
        states and lines they filed in SERFF in the last 12 months. Unknown
        query parameters and repeated scalar values are rejected. Responses are
        private, no-store.
      operationId: listCarriers
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: Name, alias or NAIC code.
          required: false
          description: Name, alias or NAIC code.
          name: q
          in: query
        - schema:
            type: string
            description: 'NAIC group: `group:785` or `785`.'
          required: false
          description: 'NAIC group: `group:785` or `785`.'
          name: group
          in: query
        - schema:
            type: string
            pattern: ^[A-Za-z]{2}$
          required: false
          name: domicile
          in: query
        - schema:
            type: string
            pattern: ^[A-Za-z]{2}$
            description: Filed in this state in SERFF in the last 12 months.
          required: false
          description: Filed in this state in SERFF in the last 12 months.
          name: state
          in: query
        - schema:
            type: string
            pattern: ^[0-9]{2}\.[0-9]$
            description: Filed under this SERFF type of insurance in the last 12 months.
            example: '17.0'
          required: false
          description: Filed under this SERFF type of insurance in the last 12 months.
          name: toi
          in: query
        - 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
            description: '`nextCursor` from the previous page.'
          required: false
          description: '`nextCursor` from the previous page.'
          name: cursor
          in: query
      responses:
        '200':
          description: One page of carriers.
          content:
            application/json:
              schema:
                type: object
                properties:
                  carriers:
                    type: array
                    items:
                      $ref: '#/components/schemas/V2CarrierRow'
                  nextCursor:
                    type: string
                    nullable: true
                    description: Cursor for the next page, or null on the last page.
                required:
                  - carriers
                  - nextCursor
        '400':
          description: >-
            Invalid or unknown filter, repeated scalar parameter, or
            invalid_cursor; restart traversal for 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'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '503':
          description: Dependency unavailable. Respect Retry-After (seconds).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2CarrierRow:
      type: object
      properties:
        id:
          type: string
          description: '`naic:` plus the 5-digit NAIC company code.'
          example: naic:38970
        name:
          type: string
        group:
          type: object
          nullable: true
          properties:
            id:
              type: string
            name:
              type: string
          required:
            - id
            - name
          description: NAIC group; id is `group:` plus the group code.
        domicile:
          type: string
          nullable: true
          description: Two-letter state of domicile.
        status:
          type: string
          enum:
            - active
            - inactive
        grossPremiumWritten:
          type: object
          nullable: true
          properties:
            year:
              type: integer
            amount:
              type: number
          required:
            - year
            - amount
          description: Latest NAIC statement, in dollars. Null without the NAIC dataset.
        cessionRatio:
          type: object
          nullable: true
          properties:
            year:
              type: integer
            value:
              type: number
          required:
            - year
            - value
          description: >-
            Premium ceded ÷ premium written (Page 14, line 35). Null without the
            NAIC dataset.
      required:
        - id
        - name
        - group
        - domicile
        - status
        - grossPremiumWritten
        - cessionRatio
      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.