---
title: "Retrieve the configuration for a benefit"
url: "https://developers.zinnia.com/apis/rate-configuration/versions/09cd2eb7-6cba-4d5f-b142-73e01c2ad670/operations/get-configuration-for-benefit"
---

> Full API specification: https://developers.zinnia.com/apis/rate-configuration/versions/09cd2eb7-6cba-4d5f-b142-73e01c2ad670.md

# Retrieve the configuration for a benefit

`GET` `/rate-configuration/v1/configurationForBenefit/carriers/{carrierId}/products/{productId}/benefits/{benefitId}`

Operation ID: `get-configuration-for-benefit`

Mirrors RateReadApi::configurationForBenefit — returns the benefit's static configuration metadata, keyed by name

## Path parameters

- `carrierId` (string, required) - The Carrier ID
- `productId` (string, required) - The Product ID
- `benefitId` (string, required) - The Benefit ID

## Query parameters

- `jurisdiction` (string, optional) - Optional Jurisdiction to be provided in ISO format
- `fixedCostPeriod` (integer, int32, optional) - Optional fixed cost period
- `productVersion` (string, optional) - Optional product version
- `issueDate` (string, date, optional) - Optional issue date

## Responses

- `200` - OK
- `401` - The caller's authentication token was missing or invalid.
- `403` - Forbidden
- `404` - Not Found
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Rate Configuration
  version: 1.0.0
servers:
  - url: https://dev.api.zinnia.io
    description: Development
paths:
  /rate-configuration/v1/configurationForBenefit/carriers/{carrierId}/products/{productId}/benefits/{benefitId}:
    get:
      tags:
        - RateRead
      operationId: get-configuration-for-benefit
      summary: Retrieve the configuration for a benefit
      description: Mirrors RateReadApi::configurationForBenefit — returns the
        benefit's static configuration metadata, keyed by name
      parameters:
        - name: carrierId
          in: path
          description: The Carrier ID
          required: true
          schema:
            type: string
          example: FNWL
        - name: productId
          in: path
          description: The Product ID
          required: true
          schema:
            type: string
          example: TR0101-20
        - name: benefitId
          in: path
          description: The Benefit ID
          required: true
          schema:
            type: string
          example: Base_Coverage
        - name: jurisdiction
          in: query
          description: Optional Jurisdiction to be provided in ISO format
          schema:
            type: string
          example: US-PA
        - name: fixedCostPeriod
          in: query
          description: Optional fixed cost period
          schema:
            type: integer
            format: int32
            default: 0
          example: 10
        - name: productVersion
          in: query
          description: Optional product version
          schema:
            type: string
          example: 25.05.01.0
        - name: issueDate
          in: query
          description: Optional issue date
          schema:
            type: string
            format: date
          example: 2026-03-20
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
        "401":
          description: The caller's authentication token was missing or invalid.
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "500":
          description: Internal Server Error
      security:
        - Auth0: []
security:
  - Auth0: []
components:
  securitySchemes:
    Auth0:
      type: openIdConnect
      description: OpenId Connect authentication
      openIdConnectUrl: https://login.dev.zinnia.com/.well-known/openid-configuration
      x-kong-security-openid-connect:
        config:
          run_on_preflight: true
          scopes_claim:
            - https://dev.api.zinnia.io/permissions
          audience_claim:
            - aud
          audience_required:
            - https://dev.api.zinnia.io
          auth_methods:
            - bearer
        enabled: true
        protocols:
          - https
```