Get formation requirements

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

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

{
  "type": "formation",
  "schema": {
    "type": "object",
    "required": [
      "jurisdiction",
      "entity_name",
      "contact",
      "principal_address",
      "organizers"
    ],
    "properties": {
      "entity_name": {
        "type": "string"
      },
      "organizers": {
        "type": "array"
      }
    }
  },
  "entity_type": "llc",
  "jurisdiction": "US-NC"
}

Filing

Get formation requirements

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

Discover the fields required and optional for a formation in a given jurisdiction and entity type. Use this before building a formation request so you know what to collect from the user.

The response groups fields into:

Common fields — required across all jurisdictions (name, principal address, people, etc.)
Jurisdiction-specific fields — extra fields the state requires (e.g., DE consent statement, NC stock requirements)
Available add-ons — whether registered-agent service and EIN bundling are supported

Returns an empty jurisdiction-specific field list when no schema has been imported for the jurisdiction; the formation endpoint will reject the submission with 501 in that case.

GET

filing

formation

requirement

Get formation requirements

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

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

{
  "type": "formation",
  "schema": {
    "type": "object",
    "required": [
      "jurisdiction",
      "entity_name",
      "contact",
      "principal_address",
      "organizers"
    ],
    "properties": {
      "entity_name": {
        "type": "string"
      },
      "organizers": {
        "type": "array"
      }
    }
  },
  "entity_type": "llc",
  "jurisdiction": "US-NC"
}

Authorizations

Authorization

string

header

required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Query Parameters

entity_type

enum<string>

required

Entity type

Available options:

llc,

corporation

jurisdiction

string

required

Jurisdiction (e.g., US-NC)

Response

200 - application/json

Formation requirements

type

string

required

Filing type

Example:

"formation"

schema

object

required

JSON Schema describing the partner-shape request body for this filing.

Example:

{
  "type": "object",
  "required": [
    "jurisdiction",
    "entity_name",
    "contact",
    "principal_address",
    "organizers"
  ],
  "properties": {
    "entity_name": { "type": "string" },
    "organizers": { "type": "array" }
  }
}

entity_type

string

Entity type

Example:

"llc"

jurisdiction

string

Jurisdiction (ISO 3166-2)

Example:

"US-NC"

Get formation fee estimate

Retrieve registered agent service

⌘I