> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Downstream Entity Licenses

> Retrieve an agency's license records by NPN

Returns the license records for the agency (downstream entity) with the given NPN under your carrier or MGA account. These are the agency's own licenses, not your organization's. The `npn` query parameter is required. You can also filter by state code and license status.


## OpenAPI

````yaml openapi/v2.json GET /v2/upstream/downstream-entity-associations/licenses
openapi: 3.0.0
info:
  title: Turris Public API
  description: API for managing insurance compliance data
  version: 2.0.0
  contact: {}
servers:
  - url: https://public.api.live.turrisfi.com
    description: Production
  - url: https://public.api.sandbox.turrisfi.com
    description: Sandbox
security: []
tags: []
paths:
  /v2/upstream/downstream-entity-associations/licenses:
    get:
      tags:
        - upstream/downstream-entity-associations
      operationId: DownstreamEntityLicensesV2Controller_getDownstreamEntityLicensesByNpn_v2
      parameters:
        - name: npn
          required: true
          in: query
          description: National Producer Number (digits only)
          schema:
            pattern: ^\d+$
            example: '1234567'
            type: string
        - name: stateCode
          required: false
          in: query
          description: State code (two-letter abbreviation)
          schema:
            example: FL
            type: string
        - name: status
          required: false
          in: query
          description: Filter for the license status
          schema:
            example: active
            type: string
      responses:
        '200':
          description: Downstream entity (agency) licenses for an NPN
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/LicenseResponse'
                  requestId:
                    type: string
                    description: Unique request identifier
                    example: dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8
                  timestamp:
                    type: string
                    description: Response timestamp
                    example: '2025-11-12T20:49:03.293Z'
                required:
                  - data
                  - requestId
                  - timestamp
        '400':
          description: Invalid query parameters (npn must be digits only)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '401':
          description: Invalid or missing auth token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '404':
          description: No agency with that NPN in your account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
components:
  schemas:
    LicenseResponse:
      type: object
      properties:
        niprDataSubscriptionId:
          type: string
          description: NIPR data subscription ID
        npn:
          type: string
          description: National Producer Number
        stateCode:
          type: string
          description: Two-letter state code
          example: AL
        licenseNumber:
          type: string
          description: License number
        licenseClassCode:
          type: string
          description: License class code
        licenseClassName:
          type: string
          description: License class name
        status:
          type: string
          description: License status
        residencyStatus:
          type: string
          description: Residency status
        issueDate:
          format: date-time
          type: string
          description: Issue date
        nextRenewalDate:
          format: date-time
          type: string
          description: Next renewal date
        expirationDate:
          format: date-time
          type: string
          description: Expiration date
        linesOfAuthority:
          description: Lines of authority
          type: array
          items:
            $ref: '#/components/schemas/LineOfAuthorityResponse'
        updatedAt:
          format: date-time
          type: string
          description: Last update timestamp
      required:
        - niprDataSubscriptionId
        - npn
        - stateCode
        - licenseNumber
        - licenseClassCode
        - licenseClassName
        - status
        - residencyStatus
    ErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP status code
        requestId:
          type: string
          description: Unique request identifier for debugging
        errorType:
          type: string
          description: >-
            Machine-readable error classification. Branch on this rather than on
            `errorMessage`, which is prose and may change. Authentication
            failures returned by our identity provider are forwarded verbatim,
            so a 401 can carry a code outside this list; treat an unrecognised
            value as a generic failure of its HTTP status.
          enum:
            - conflict
            - contact_not_authorized
            - document_exceeds_page_limit
            - downstream_entity_member_exists
            - duplicate_external_id_error
            - duplicate_member_email
            - duplicate_producer_code_error
            - forbidden
            - gateway_timeout
            - inactive_email
            - internal_server_error
            - invalid_email
            - invalid_email_for_invites
            - invalid_organization_category
            - invalid_organization_slug
            - invalid_phone_number
            - invalid_token
            - invite_limit_reached
            - jwt_invalid
            - m2m_client_not_found
            - not_found
            - organization_already_exists
            - organization_slug_already_used
            - payment_required
            - producer_agreement_required
            - product_feature_subscription_required
            - service_unavailable
            - session_authorization_error
            - some_custom_error_string
            - throttled
            - too_many_requests
            - unauthorized
            - unauthorized_client
            - unexpected_400_stytch_error
            - unexpected_403_stytch_error
            - unexpected_404_stytch_error
            - unexpected_error
            - unexpected_stytch_error
            - unprocessable_entity
            - validation_error
          example: validation_error
        errorMessage:
          description: Array of error messages
          type: array
          items:
            type: string
        timestamp:
          type: string
          description: ISO timestamp when the error occurred
        details:
          type: object
          description: Additional error context
      required:
        - statusCode
        - requestId
        - errorType
        - errorMessage
        - timestamp
    LineOfAuthorityResponse:
      type: object
      properties:
        code:
          type: string
          description: Line of authority code
        name:
          type: string
          description: Line of authority name
        status:
          type: string
          description: Line of authority status
      required:
        - code
        - name
        - status

````

## Related topics

- [Changelog](/changelog.md)
- [Get Downstream Entity Licenses](/api-reference/v2/licenses/downstream-entity-licenses.md)
- [Get All Agent Licenses](/api-reference/v2/licenses/all-agent-licenses.md)