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

# Get recorded product marketing in a state

> Links to published material on who the product is marketed to in one state: agent and broker appetite and underwriting guides, applications, agent rate sheets, and product pages that say who the product is for or who qualifies. Not filed with the state, and not stored: each link is a URL on the web with its title, publisher and kind, in recorded order. Empty means nothing recorded. Access: needs access to the product in this state.



## OpenAPI

````yaml /openapi.json get /insurance/products/{productId}/availability/{state}/marketing
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/products/{productId}/availability/{state}/marketing:
    get:
      tags:
        - Products
      summary: Get recorded product marketing in a state
      description: >-
        Links to published material on who the product is marketed to in one
        state: agent and broker appetite and underwriting guides, applications,
        agent rate sheets, and product pages that say who the product is for or
        who qualifies. Not filed with the state, and not stored: each link is a
        URL on the web with its title, publisher and kind, in recorded order.
        Empty means nothing recorded. Access: needs access to the product in
        this state.
      operationId: getProductAvailabilityMarketing
      parameters:
        - schema:
            type: string
            description: >-
              Managed product_ ID or bare checked code; case-insensitive with
              Crockford aliases.
          required: true
          description: >-
            Managed product_ ID or bare checked code; case-insensitive with
            Crockford aliases.
          name: productId
          in: path
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              A configured state code from availabilitySummary.states,
              case-insensitive.
            example: TX
          required: true
          description: >-
            A configured state code from availabilitySummary.states,
            case-insensitive.
          name: state
          in: path
      responses:
        '200':
          description: Marketing note and links.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2ProductMarketing'
        '400':
          description: >-
            Invalid request, invalid_id or invalid_cursor; restart traversal for
            an invalid cursor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '403':
          description: >-
            product_access_required: needs access to the product and, where the
            request names one, the state; checked first. Other credential
            restrictions use forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '404':
          description: Product or availability not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '429':
          description: Rate limited. Honor Retry-After seconds.
          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:
    V2ProductMarketing:
      type: object
      properties:
        note:
          type: string
          nullable: true
        links:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
                description: The page or document on the web.
              title:
                type: string
                nullable: true
              publisher:
                type: string
                nullable: true
                description: Who published it, such as carrier, mga, broker or third_party.
              kind:
                type: string
                nullable: true
                description: >-
                  What it is, such as agent_guide, application, rate_sheet,
                  website or faq.
            required:
              - url
              - title
              - publisher
              - kind
            additionalProperties: false
      required:
        - note
        - links
      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
              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.