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

# Get a carrier Schedule P loss development row

> Requires the organization’s NAIC dataset grant after acceptance of the NAIC terms. The grant is checked before carrier lookup on every request. Each nonempty successful request costs $0.02 plus $0.05 per returned row; one row is one printed accident-year, prior, totals or earned-premium row of one page. Empty results and failed requests are not charged; repeated successful reads are charged again. Use the ID returned by listCarrierLossDevelopmentRows under the same carrier. Reads the current loaded value of the source row, not an immutable revision. A removed row or wrong carrier returns 404. Accepts no query parameters. Read-only; private, no-store.



## OpenAPI

````yaml /openapi.json get /insurance/carriers/{carrierId}/loss-development/{id}
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.canary.effectiveai.app/api/v2
    description: Canary
security:
  - bearerAuth: []
paths:
  /insurance/carriers/{carrierId}/loss-development/{id}:
    get:
      tags:
        - NAIC statutory data
      summary: Get a carrier Schedule P loss development row
      description: >-
        Requires the organization’s NAIC dataset grant after acceptance of the
        NAIC terms. The grant is checked before carrier lookup on every request.
        Each nonempty successful request costs $0.02 plus $0.05 per returned
        row; one row is one printed accident-year, prior, totals or
        earned-premium row of one page. Empty results and failed requests are
        not charged; repeated successful reads are charged again. Use the ID
        returned by listCarrierLossDevelopmentRows under the same carrier. Reads
        the current loaded value of the source row, not an immutable revision. A
        removed row or wrong carrier returns 404. Accepts no query parameters.
        Read-only; private, no-store.
      operationId: getCarrierLossDevelopmentRow
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 100
            description: >-
              Managed carrier_ ID or bare checked code. Legacy five-digit NAIC
              codes and naic: codes are also accepted.
          required: true
          description: >-
            Managed carrier_ ID or bare checked code. Legacy five-digit NAIC
            codes and naic: codes are also accepted.
          name: carrierId
          in: path
        - schema:
            type: string
            maxLength: 200
          required: true
          name: id
          in: path
      responses:
        '200':
          description: One Schedule P row, with the same representation as the list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CarrierLossDevelopmentRow'
        '400':
          description: >-
            invalid_request for invalid, missing, unknown or repeated scalar
            inputs; invalid_id for a malformed carrier; invalid_cursor requires
            restarting traversal.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '403':
          description: >-
            dataset_not_enabled: NAIC terms and organization entitlement are
            required. No charge. Other credential restrictions use forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '404':
          description: >-
            not_found for an unknown carrier or missing/wrong-parent item;
            statutory_data_not_found when the carrier has no loaded Schedule P
            data for the selected year. This does not prove it did not file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '500':
          description: Unexpected source or server failure; no charge.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '503':
          description: A dependency is unavailable; respect Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2CarrierLossDevelopmentRow:
      type: object
      properties:
        id:
          type: string
          description: >-
            Opaque row ID. Pass unchanged to the item GET under the same
            carrier. Identifies the source row, not an immutable value.
        carrier:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
          required:
            - id
            - name
        naicCompanyCode:
          type: string
          description: >-
            Five-digit source NAIC company code, separate from the managed
            carrier ID.
        statementYear:
          type: integer
          minimum: 1900
          maximum: 9999
          description: Annual statement year that reported this row.
        line:
          type: object
          properties:
            code:
              type: string
              enum:
                - A
                - B
                - C
                - D
                - E
                - F
                - G
                - H
                - I
                - J
                - K
                - L
                - M
                - 'N'
                - O
                - P
                - R
                - S
                - T
                - U
                - SUMMARY
              description: >-
                Lettered Schedule P line, a separate scheme from numbered
                statement lines: A Homeowners/Farmowners; B Private Passenger
                Auto Liability; C Commercial Auto/Truck Liability/Medical; D
                Workers' Compensation; E Commercial Multiple Peril; F Medical
                Professional Liability; G Special Liability (Ocean Marine,
                Aircraft, Boiler & Machinery); H Other Liability; I Special
                Property (Fire, Allied Lines, Inland Marine, Earthquake); J Auto
                Physical Damage; K Fidelity & Surety; L Other (Including Credit,
                Accident & Health); M International; N Reinsurance -
                Nonproportional Assumed Property; O Reinsurance -
                Nonproportional Assumed Liability; P Reinsurance -
                Nonproportional Assumed Financial Lines; R Products Liability; S
                Financial Guaranty/Mortgage Guaranty; T Warranty; U Pet
                Insurance Plans; SUMMARY All Lines Combined. SUMMARY is the
                reported all-lines page; never add it to lettered lines.
            name:
              type: string
              description: >-
                Loaded line label. For F, H and R it names the occurrence or
                claims-made page.
            scheme:
              type: string
              enum:
                - schedule-p
          required:
            - code
            - name
            - scheme
        part:
          type: string
          enum:
            - '2'
            - '3'
            - '4'
            - '5'
            - '6'
          description: >-
            Schedule P part: 2 incurred and 3 paid net losses and defense and
            cost containment (DCC) expenses, 4 bulk and IBNR net reserves, 5
            claim counts, 6 premiums earned.
        section:
          type: string
          nullable: true
          description: >-
            Reported page section, such as 1, 2 or 1A; null when the page has no
            sections. Part 6 sections 1, 1A and 1B are direct and assumed; 2, 2A
            and 2B are ceded.
        variant:
          type: string
          description: Reported page variant, such as R - SECTION 1.
        sourceRow:
          type: string
          description: >-
            Two-digit printed row number on the page. 01 is prior years, 02 to
            11 are accident years, 12 is totals and 13 is the Part 6
            earned-premium row.
        rowType:
          type: string
          enum:
            - prior
            - accident_year
            - totals
            - earned_premiums
        accidentYear:
          type: integer
          nullable: true
          minimum: 1900
          maximum: 9999
          description: >-
            Accident year (Part 6: year premiums were earned) for accident-year
            rows; null otherwise.
        development:
          type: object
          nullable: true
          properties:
            measure:
              type: string
              enum:
                - incurred_net_losses_and_dcc
                - one_year_development
                - two_year_development
                - paid_net_losses_and_dcc
                - claims_closed_with_loss_payment
                - claims_closed_without_loss_payment
                - bulk_and_ibnr_net_reserves
                - claims_outstanding
                - claims_reported
                - direct_and_assumed_premiums_earned
                - ceded_premiums_earned
                - schedule_p_part_1_premiums_earned
                - current_year_premiums_earned
            unit:
              type: string
              enum:
                - usd
                - count
              description: >-
                usd: whole US dollars, scaled from reported thousands. count:
                number of claims.
            values:
              type: array
              items:
                type: object
                properties:
                  evaluationYear:
                    type: integer
                    minimum: 1900
                    maximum: 9999
                  developmentMonths:
                    type: integer
                    nullable: true
                    description: >-
                      Months from the start of the accident year; null for other
                      rows.
                  value:
                    type: integer
                    description: >-
                      Reported value in the stated unit. Negative values are
                      preserved.
                required:
                  - evaluationYear
                  - developmentMonths
                  - value
              maxItems: 10
              description: >-
                Reported cells in ascending evaluation year. The source load
                drops blank and zero cells, so an absent year is blank or zero,
                not evidence of either.
          required:
            - measure
            - unit
            - values
          description: >-
            The development triangle cells for this row. Parts 2 to 4 are net of
            reinsurance. Part 5 counts are direct and assumed. Null when the row
            reports only supplemental columns.
        supplemental:
          type: array
          items:
            type: object
            properties:
              measure:
                type: string
                enum:
                  - incurred_net_losses_and_dcc
                  - one_year_development
                  - two_year_development
                  - paid_net_losses_and_dcc
                  - claims_closed_with_loss_payment
                  - claims_closed_without_loss_payment
                  - bulk_and_ibnr_net_reserves
                  - claims_outstanding
                  - claims_reported
                  - direct_and_assumed_premiums_earned
                  - ceded_premiums_earned
                  - schedule_p_part_1_premiums_earned
                  - current_year_premiums_earned
              unit:
                type: string
                enum:
                  - usd
                  - count
                description: >-
                  usd: whole US dollars, scaled from reported thousands. count:
                  number of claims.
              value:
                type: integer
                description: >-
                  Reported value in the stated unit. Negative values are
                  preserved.
            required:
              - measure
              - unit
              - value
          description: >-
            Reported columns beside the triangle: Part 2 one- and two-year
            development, Part 3 closed claim counts and Part 6 current-year
            premiums earned. Blank and zero columns are absent.
        sources:
          type: array
          items:
            $ref: '#/components/schemas/V2NaicSource'
      required:
        - id
        - carrier
        - naicCompanyCode
        - statementYear
        - line
        - part
        - section
        - variant
        - sourceRow
        - rowType
        - accidentYear
        - development
        - supplemental
        - sources
    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
              description: Dataset needed for dataset_not_enabled.
          required:
            - code
    V2NaicSource:
      type: object
      properties:
        exhibit:
          type: string
        statementYear:
          type: integer
          minimum: 1900
          maximum: 9999
      required:
        - exhibit
        - statementYear
    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.