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, or authorized capital and need extra query parameters:

authorized_shares — required by DE/MA/MI/VA corporations
par_value and par_value_type — required by DE corporations
authorized_capital — required by DC/MO corporations
pages — document page count, required by DE corporations
paid_in_capital — required by IL corporations
expedited_tier — optional; adds the expedited surcharge for that speed where the state offers expedited processing

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

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 DE/MA/MI/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