> ## 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 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](mailto:support@getpalm.com) before building on it.

Discover which fields a formation needs for a given jurisdiction and entity type. Call this before building a formation request so you know what to collect from the user.

The response groups fields into:

- **Common fields** — required everywhere (name, principal address, people, etc.)
- **Jurisdiction-specific fields** — extra fields the state requires
- **Available add-ons** — whether registered-agent service and EIN bundling are supported

`expedited_tiers` lists the expedited processing tiers the state offers (the accepted `expedited_tier` values on create); price each one with the [formation fee endpoint](/api-reference/v1/filing/get-formation-fee-estimate).

If Palm does not yet support formations in a jurisdiction, the jurisdiction-specific list comes back empty and submitting a formation there returns `501`.



## OpenAPI

````yaml /api-reference/v1/openapi.json get /v1/filing/formation/requirement
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/requirement:
    get:
      tags:
        - Filing
      summary: Get formation requirements
      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.


        Discover which fields a formation needs for a given jurisdiction and
        entity type. Call this before building a formation request so you know
        what to collect from the user.


        The response groups fields into:


        - **Common fields** — required everywhere (name, principal address,
        people, etc.)

        - **Jurisdiction-specific fields** — extra fields the state requires

        - **Available add-ons** — whether registered-agent service and EIN
        bundling are supported


        `expedited_tiers` lists the expedited processing tiers the state offers
        (the accepted `expedited_tier` values on create); price each one with
        the [formation fee
        endpoint](/api-reference/v1/filing/get-formation-fee-estimate).


        If Palm does not yet support formations in a jurisdiction, the
        jurisdiction-specific list comes back empty and submitting a formation
        there returns `501`.
      operationId: getFormationRequirements
      parameters:
        - name: entity_type
          required: true
          in: query
          description: Entity type
          schema:
            enum:
              - llc
              - pllc
              - corporation
              - pcorporation
            type: string
        - name: jurisdiction
          required: true
          in: query
          description: Jurisdiction (e.g., US-NC)
          schema:
            type: string
      responses:
        '200':
          description: Formation requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingRequirementResult'
      security:
        - ApiKey: []
components:
  schemas:
    FilingRequirementResult:
      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
        expedited_tiers:
          description: >-
            Expedited processing tiers this jurisdiction offers, accepted as the
            `expedited_tier` value on the formation create endpoints. Empty
            array when the state offers no expedited option. Present only when a
            jurisdiction is supplied. For the cost of each tier, call GET
            /v1/filing/formation/fee — the `expedited_tiers` field prices them.
          example:
            - 24_hour
            - same_day
            - 1_hour
          type: array
          items:
            type: string
        schema:
          type: object
          description: JSON Schema describing the request body for this filing.
          additionalProperties: true
          example:
            type: object
            required:
              - jurisdiction
              - entity_name
              - purpose
              - email
              - contact
              - principal_address
              - organizers
            properties:
              entity_name:
                type: string
              purpose:
                type: string
              email:
                type: string
                format: email
                description: Business email address
              contact:
                type: object
                required:
                  - name
                  - email
                properties:
                  name:
                    type: string
                  email:
                    type: string
                    format: email
                  phone:
                    type: string
              principal_address:
                type: object
                description: Principal office address
                required:
                  - street_line_1
                  - city
                  - region
                  - postal_code
                  - country
                properties:
                  street_line_1:
                    type: string
                  city:
                    type: string
                  region:
                    type: string
                    description: State or region code
                  postal_code:
                    type: string
                  country:
                    type: string
                    description: ISO 3166-1 alpha-2 country code
              mailing_address:
                type: object
                description: Mailing address if different from principal office
                properties:
                  street_line_1:
                    type: string
                  city:
                    type: string
                  region:
                    type: string
                    description: State or region code
                  postal_code:
                    type: string
                  country:
                    type: string
                    description: ISO 3166-1 alpha-2 country code
              registered_agent:
                type: object
                required:
                  - type
                  - name
                  - address
                properties:
                  type:
                    type: string
                    enum:
                      - person
                      - organization
                  name:
                    type: object
                    description: A person or an entity. Discriminated by `type`.
                    required:
                      - type
                    properties:
                      type:
                        type: string
                        enum:
                          - person
                          - entity
                      first:
                        type: string
                        description: Required when type is "person"
                      last:
                        type: string
                        description: Required when type is "person"
                      entity_name:
                        type: string
                        description: Required when type is "entity"
                  address:
                    type: object
                    description: >-
                      Registered office address (must be in the formation
                      jurisdiction)
                    properties:
                      street_line_1:
                        type: string
                      city:
                        type: string
                      region:
                        type: string
                      postal_code:
                        type: string
                      country:
                        type: string
              organizers:
                type: array
                minItems: 1
                items:
                  type: object
                  required:
                    - name
                    - address
                  properties:
                    name:
                      type: object
                      required:
                        - type
                      properties:
                        type:
                          type: string
                          enum:
                            - person
                            - entity
                        first:
                          type: string
                        last:
                          type: string
                        entity_name:
                          type: string
                    address:
                      type: object
                      description: Party address
                    title:
                      type: string
              tax_accounts:
                type: array
                items:
                  type: string
                  enum:
                    - sales_tax
              fein:
                type: string
              ldr_sales_tax:
                type: object
            allOf:
              - if:
                  properties:
                    tax_accounts:
                      contains:
                        const: sales_tax
                  required:
                    - tax_accounts
                then:
                  required:
                    - ldr_sales_tax
                    - fein
      required:
        - type
        - schema
  securitySchemes:
    ApiKey:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx'

````