> ## 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 formation 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 fees for a formation before submitting — useful for showing cost upfront or for billing reconciliation.

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 (`base + dynamic + late + credit_card`), so you do not have to sum the components yourself. It is always an estimate.

**Extra inputs.** Some states price the filing on share count, par value, authorized capital, or member count and need extra query parameters — for LLCs as well as corporations:

- `authorized_shares` — required by CT/DE/KY/MA/MI/NM/RI/VA corporations
- `par_value` and `par_value_type` — required by DE corporations; `par_value_type` is `par` or `no_par`, and `par_value` is the per-share par value in USD (ignored when `no_par`)
- `authorized_capital` — total authorized capital in USD, required by DC/MO corporations
- `pages` — document page count, required by DE corporations
- `paid_in_capital` — required by IL corporations
- `aggregate_par_value` — aggregate par value of all authorized stock (par value × authorized shares) in USD, required by MD corporations
- `member_count` — number of LLC members, required by TN LLCs
- `startup_for_soldiers` — `true` when the filer qualifies for Missouri’s Startup for Soldiers fee waiver (active-duty military in Missouri forming a new business), required by MO corporations
- `expedited_tier` — optional; adds the expedited surcharge for that speed where the state offers expedited processing (tiers seen today: `expedited`, `24_hour`, `same_day`, `3_hour`, `2_hour`, `1_hour`)

Any other query parameter is also forwarded to the fee calculation as an extra input, so if a `400` lists a required input not documented here, supply it as a query parameter with that name. Numeric values and `true`/`false` are coerced from the query string automatically.

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 as an `{ amount, currency }` pair (total cost = the standard fee components + `fee.amount`). Submit your chosen tier on the create endpoint via `expedited_tier`.

If required inputs are missing, the endpoint returns `400` listing them.



## OpenAPI

````yaml /api-reference/v1/openapi.json get /v1/filing/formation/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
paths:
  /v1/filing/formation/fee:
    get:
      tags:
        - Filing
      summary: Get formation 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 fees for a formation before submitting — useful for showing
        cost upfront or for billing reconciliation.


        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
        (`base + dynamic + late + credit_card`), so you do not have to sum the
        components yourself. It is always an estimate.


        **Extra inputs.** Some states price the filing on share count, par
        value, authorized capital, or member count and need extra query
        parameters — for LLCs as well as corporations:


        - `authorized_shares` — required by CT/DE/KY/MA/MI/NM/RI/VA corporations

        - `par_value` and `par_value_type` — required by DE corporations;
        `par_value_type` is `par` or `no_par`, and `par_value` is the per-share
        par value in USD (ignored when `no_par`)

        - `authorized_capital` — total authorized capital in USD, required by
        DC/MO corporations

        - `pages` — document page count, required by DE corporations

        - `paid_in_capital` — required by IL corporations

        - `aggregate_par_value` — aggregate par value of all authorized stock
        (par value × authorized shares) in USD, required by MD corporations

        - `member_count` — number of LLC members, required by TN LLCs

        - `startup_for_soldiers` — `true` when the filer qualifies for
        Missouri’s Startup for Soldiers fee waiver (active-duty military in
        Missouri forming a new business), required by MO corporations

        - `expedited_tier` — optional; adds the expedited surcharge for that
        speed where the state offers expedited processing (tiers seen today:
        `expedited`, `24_hour`, `same_day`, `3_hour`, `2_hour`, `1_hour`)


        Any other query parameter is also forwarded to the fee calculation as an
        extra input, so if a `400` lists a required input not documented here,
        supply it as a query parameter with that name. Numeric values and
        `true`/`false` are coerced from the query string automatically.


        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 as an `{ amount, currency }` pair (total
        cost = the standard fee components + `fee.amount`). Submit your chosen
        tier on the create endpoint via `expedited_tier`.


        If required inputs are missing, the endpoint returns `400` listing them.
      operationId: getFormationFeeEstimate
      parameters:
        - name: startup_for_soldiers
          required: false
          in: query
          description: >-
            Whether the filer qualifies for the Startup for Soldiers fee waiver
            (required by MO corporations)
          schema:
            type: boolean
        - name: member_count
          required: false
          in: query
          description: Number of LLC members (required by TN LLCs)
          schema:
            type: number
        - name: aggregate_par_value
          required: false
          in: query
          description: >-
            Aggregate par value of all authorized stock (par value × authorized
            shares), in USD (required by MD corporations)
          schema:
            type: number
        - name: paid_in_capital
          required: false
          in: query
          description: Paid-in capital (required by IL corporations)
          schema:
            type: number
        - name: pages
          required: false
          in: query
          description: Document page count (required by DE corporations)
          schema:
            type: number
        - name: authorized_capital
          required: false
          in: query
          description: Authorized capital (required by DC/MO corporations)
          schema:
            type: number
        - name: par_value_type
          required: false
          in: query
          description: 'Par value type: "par" or "no_par" (required by DE corporations)'
          schema: {}
        - name: par_value
          required: false
          in: query
          description: Par value per share (required by DE corporation)
          schema:
            type: number
        - name: authorized_shares
          required: false
          in: query
          description: >-
            Number of authorized shares (required by CT/DE/KY/MA/MI/NM/RI/VA
            corporations)
          schema:
            type: number
        - name: expedited_tier
          required: false
          in: query
          description: >-
            Expedited processing tier (e.g., expedited, 24_hour, same_day,
            3_hour, 2_hour, 1_hour). Omit for standard processing.
          schema: {}
        - name: jurisdiction
          required: true
          in: query
          description: Jurisdiction (e.g., US-NC)
          schema: {}
        - name: entity_type
          required: true
          in: query
          description: Entity type
          schema:
            enum:
              - llc
              - pllc
              - corporation
              - pcorporation
            type: string
      responses:
        '200':
          description: Fee estimate
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingFeeEstimateResult'
              examples:
                flat_fee:
                  summary: Flat fee jurisdiction (NC LLC)
                  value:
                    type: formation
                    entity_type: llc
                    jurisdiction: US-NC
                    fee:
                      base:
                        amount: 125
                        currency: USD
                      ach:
                        amount: 2
                        currency: USD
                      credit_card:
                        amount: 3
                        currency: USD
                      dynamic:
                        amount: 0
                        currency: USD
                      late:
                        amount: 0
                        currency: USD
                      total:
                        amount: 128
                        currency: USD
                      items:
                        - component_type: base
                          name: filing
                          amount: 125
                          currency: USD
                        - component_type: ach
                          name: default
                          amount: 2
                          currency: USD
                        - component_type: credit_card
                          name: default
                          amount: 3
                          currency: USD
                menu:
                  summary: Standard fee + expedited menu (no expedited_tier requested)
                  value:
                    type: formation
                    entity_type: llc
                    jurisdiction: US-DE
                    fee:
                      base:
                        amount: 110
                        currency: USD
                      dynamic:
                        amount: 0
                        currency: USD
                      total:
                        amount: 110
                        currency: USD
                      items:
                        - component_type: base
                          name: filing
                          amount: 110
                          currency: USD
                    expedited_tiers:
                      - tier: 24_hour
                        fee:
                          amount: 50
                          currency: USD
                      - tier: same_day
                        fee:
                          amount: 100
                          currency: USD
                      - tier: 2_hour
                        fee:
                          amount: 500
                          currency: USD
                      - tier: 1_hour
                        fee:
                          amount: 1000
                          currency: USD
                expedited:
                  summary: With expedited processing (NC LLC + same_day)
                  value:
                    type: formation
                    entity_type: llc
                    jurisdiction: US-NC
                    fee:
                      base:
                        amount: 125
                        currency: USD
                      ach:
                        amount: 2
                        currency: USD
                      credit_card:
                        amount: 3
                        currency: USD
                      dynamic:
                        amount: 200
                        currency: USD
                      late:
                        amount: 0
                        currency: USD
                      total:
                        amount: 328
                        currency: USD
                      items:
                        - component_type: base
                          name: filing
                          amount: 125
                          currency: USD
                        - component_type: dynamic
                          name: expedited
                          amount: 200
                          currency: USD
                        - component_type: ach
                          name: default
                          amount: 2
                          currency: USD
                        - component_type: credit_card
                          name: default
                          amount: 3
                          currency: USD
                itemized:
                  summary: >-
                    Itemized base + tax + expedited (CT corporation, 1M shares +
                    expedited)
                  value:
                    type: formation
                    entity_type: corporation
                    jurisdiction: US-CT
                    fee:
                      base:
                        amount: 100
                        currency: USD
                      dynamic:
                        amount: 2850
                        currency: USD
                      late:
                        amount: 0
                        currency: USD
                      ach:
                        amount: 0
                        currency: USD
                      credit_card:
                        amount: 0
                        currency: USD
                      total:
                        amount: 2950
                        currency: USD
                      items:
                        - component_type: base
                          name: filing
                          amount: 100
                          currency: USD
                        - component_type: dynamic
                          name: expedited
                          amount: 50
                          currency: USD
                        - component_type: dynamic
                          name: franchise_tax
                          amount: 2800
                          currency: USD
                share_based:
                  summary: Share-based jurisdiction (MA corporation, 1M shares)
                  value:
                    type: formation
                    entity_type: corporation
                    jurisdiction: US-MA
                    fee:
                      base:
                        amount: 1075
                        currency: USD
                      ach:
                        amount: 0
                        currency: USD
                      credit_card:
                        amount: 0
                        currency: USD
                      dynamic:
                        amount: 0
                        currency: USD
                      late:
                        amount: 0
                        currency: USD
                      total:
                        amount: 1075
                        currency: USD
                      items:
                        - component_type: base
                          name: filing
                          amount: 1075
                          currency: USD
        '400':
          description: Missing or invalid query parameters
        '404':
          description: Fee data not available for this jurisdiction
      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'

````