Get formation fee estimate

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/filing/formation/fee', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getpalm.com/v1/filing/formation/fee"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.getpalm.com/v1/filing/formation/fee \
  --header 'Authorization: Bearer <token>'

{
  "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"
      }
    ]
  }
}

Filing

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

GET

filing

formation

fee

Get formation fee estimate

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/filing/formation/fee', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getpalm.com/v1/filing/formation/fee"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.getpalm.com/v1/filing/formation/fee \
  --header 'Authorization: Bearer <token>'

{
  "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"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Query Parameters

startup_for_soldiers

boolean

Whether the filer qualifies for the Startup for Soldiers fee waiver (required by MO corporations)

member_count

number

Number of LLC members (required by TN LLCs)

aggregate_par_value

number

Aggregate par value of all authorized stock (par value × authorized shares), in USD (required by MD corporations)

paid_in_capital

number

Paid-in capital (required by IL corporations)

pages

number

Document page count (required by DE corporations)

authorized_capital

number

Authorized capital (required by DC/MO corporations)

par_value

number

Par value per share (required by DE corporation)

authorized_shares

number

Number of authorized shares (required by CT/DE/KY/MA/MI/NM/RI/VA corporations)

entity_type

enum<string>

required

Entity type

Available options:

llc,

pllc,

corporation,

pcorporation

Response

Fee estimate

type

string

required

Filing type

Example:

"formation"

jurisdiction

string

required

Jurisdiction (ISO 3166-2)

Example:

"US-NC"

fee

object

required

Fee breakdown by component, with an optional itemized list.

Show child attributes

entity_type

string

Entity type

Example:

"llc"

expedited_tiers

object[]

Priced menu of expedited tiers the jurisdiction offers. Present only when expedited_tier was not supplied and the state offers expedited processing.

Show child attributes

Retrieve a filing

Get formation requirements

⌘I

Palm Introduction

API Introduction

Endpoints

Get formation fee estimate

Authorizations

Query Parameters

Response