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

# Get foreign qualification fee estimate

> > **⚠️ Early access** — This endpoint is in preview and may change in backwards-incompatible ways before it is marked stable. Avoid depending on it in production, and [reach out](mailto:support@getpalm.com) before building on it.

Estimate the government fees for registering an existing business in a state before submitting.

Fees are broken down by component (`base`, `dynamic`, `late`, `credit_card`, `ach`); only the components that apply to the jurisdiction are returned. `fee.total` is the all-in grand total assuming credit-card payment. It is always an estimate.

Omit `expedited_tier` and, where the state offers expedited processing, the response includes `expedited_tiers`: a menu of `{ tier, fee }` where `fee` is the added surcharge for that speed. Pass `expedited_tier` to fold one tier’s surcharge into the components instead.

Any other query parameter is forwarded to the fee calculation as an extra input; a `400` lists any input the state requires that was not supplied. Returns `404` where no fee data is available for the jurisdiction.



## OpenAPI

````yaml /api-reference/v1/openapi.json get /v1/filing/foreign-qualification/fee
openapi: 3.0.0
info:
  title: Palm Partner API
  description: >-
    The Palm API is identity verification and compliance infrastructure for US
    businesses: onboard businesses, verify businesses and people (KYB/KYC)
    against authoritative sources, monitor them for changes in real time, and
    act on their behalf through filings, formation, and registered agent
    services.
  version: '1.0'
  contact:
    name: Palm Support
    url: https://getpalm.com
    email: support@getpalm.com
  termsOfService: https://getpalm.com/terms
  license:
    name: Proprietary
    url: https://getpalm.com/license
servers:
  - url: https://api.getpalm.com
    description: Production
security: []
tags:
  - name: Registry
    description: Search business registries
  - name: Business
    description: Manage the businesses in your portfolio
  - name: User
    description: Manage the people in your portfolio
  - name: Verification
    description: Identity and business verification
  - name: Monitor
    description: Continuous monitoring of businesses
  - name: Filing
    description: Form a business, apply for an EIN, and register in additional states
  - name: Case
    description: Answer a request for information that a filing is waiting on
  - name: Registered Agent
    description: Registered agent service for a business
  - name: Documents
    description: Retrieve and download any document held for a business or a person
paths:
  /v1/filing/foreign-qualification/fee:
    get:
      tags:
        - Filing
      summary: Get foreign qualification fee estimate
      description: >-
        > **⚠️ Early access** — This endpoint is in preview and may change in
        backwards-incompatible ways before it is marked stable. Avoid depending
        on it in production, and [reach out](mailto:support@getpalm.com) before
        building on it.


        Estimate the government fees for registering an existing business in a
        state before submitting.


        Fees are broken down by component (`base`, `dynamic`, `late`,
        `credit_card`, `ach`); only the components that apply to the
        jurisdiction are returned. `fee.total` is the all-in grand total
        assuming credit-card payment. It is always an estimate.


        Omit `expedited_tier` and, where the state offers expedited processing,
        the response includes `expedited_tiers`: a menu of `{ tier, fee }` where
        `fee` is the added surcharge for that speed. Pass `expedited_tier` to
        fold one tier’s surcharge into the components instead.


        Any other query parameter is forwarded to the fee calculation as an
        extra input; a `400` lists any input the state requires that was not
        supplied. Returns `404` where no fee data is available for the
        jurisdiction.
      operationId: getForeignQualificationFeeEstimate
      parameters:
        - name: expedited_tier
          required: false
          in: query
          description: >-
            Expedited processing tier to price. Omit for standard processing and
            the priced menu of tiers.
          schema: {}
        - name: jurisdiction
          required: true
          in: query
          description: The state to register in (e.g., US-TX)
          schema: {}
        - name: entity_type
          required: true
          in: query
          description: Entity type of the existing business
          schema:
            enum:
              - llc
              - professional_llc
              - corporation
              - professional_corporation
            type: string
      responses:
        '200':
          description: Fee estimate
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingFeeEstimateResult'
        '400':
          description: Missing or invalid query parameters
        '404':
          description: Fee data not available for this jurisdiction
        '501':
          description: The entity type is not yet supported
      security:
        - ApiKey: []
components:
  schemas:
    FilingFeeEstimateResult:
      type: object
      properties:
        type:
          type: string
          description: Filing type
          example: formation
        entity_type:
          type: string
          description: Entity type
          example: llc
        jurisdiction:
          type: string
          description: Jurisdiction (ISO 3166-2)
          example: US-NC
        fee:
          description: Fee breakdown by component, with an optional itemized list.
          allOf:
            - $ref: '#/components/schemas/FeeBreakdown'
        expedited_tiers:
          description: >-
            Priced menu of expedited tiers the jurisdiction offers. Present only
            when `expedited_tier` was not supplied and the state offers
            expedited processing.
          type: array
          items:
            $ref: '#/components/schemas/ExpeditedFeeOption'
      required:
        - type
        - jurisdiction
        - fee
    FeeBreakdown:
      type: object
      properties:
        base:
          description: Base filing fee total.
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
        dynamic:
          description: >-
            Variable fee total (e.g. franchise tax, share-based or expedited
            surcharges).
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
        late:
          description: Late fee total.
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
        credit_card:
          description: Credit-card payment surcharge total.
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
        ach:
          description: ACH payment surcharge total.
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
        total:
          description: >-
            Grand total across the applicable fee components — a convenience so
            you do not have to sum the breakdown yourself. Assumes a credit-card
            payment method, so it is `base + dynamic + late + credit_card` (the
            mutually-exclusive `ach` surcharge is excluded). `items` and any
            `expedited_tiers` menu are not included; a requested
            `expedited_tier` surcharge is already in `dynamic`. Always an
            estimate.
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
        items:
          description: >-
            Itemized breakdown — one entry per evaluated rule. Component totals
            above are sums across these.
          type: array
          items:
            $ref: '#/components/schemas/FeeLine'
      required:
        - total
    ExpeditedFeeOption:
      type: object
      properties:
        tier:
          type: string
          description: >-
            Expedited tier identifier, accepted as `expedited_tier` on the
            formation create endpoints.
          example: same_day
        fee:
          description: Added expedited surcharge for this tier.
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
      required:
        - tier
        - fee
    FeeAmount:
      type: object
      properties:
        amount:
          type: number
          description: Fee amount in whole units
          example: 125
        currency:
          type: string
          description: Currency code
          example: USD
      required:
        - amount
        - currency
    FeeLine:
      type: object
      properties:
        component_type:
          type: string
          description: Component type this rule rolls up under
          enum:
            - base
            - dynamic
            - late
            - credit_card
            - ach
          example: dynamic
        name:
          type: string
          description: >-
            Stable identifier within the component (e.g., "filing",
            "franchise_tax", "expedited"). "default" when there is exactly one
            rule for this component.
          example: franchise_tax
        amount:
          type: number
          description: Fee amount in whole units
          example: 500
        currency:
          type: string
          description: Currency code
          example: USD
      required:
        - component_type
        - name
        - amount
        - currency
  securitySchemes:
    ApiKey:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx'

````