> ## 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 foreign qualification 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 what registering an existing business in a given state needs. Call this before building a request so you know what to collect.

`schema` is a JSON Schema of the request body: the common fields plus the fields the state requires. Everything Palm reads from the referenced business (legal name, entity type, formation jurisdiction, formation date, registration number) is absent, since you never supply it.

`prerequisites` lists the documents the state needs alongside the application, each with whether it is always required and who supplies it; Palm orders the home-state certificate as part of the filing. `signature_requirements` lists who must sign. `post_filing_obligations` lists what the registration starts once accepted. `channel` says whether the state files online or by mail, or is null when not yet known.

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

Returns `501` for a state Palm does not yet support.



## OpenAPI

````yaml /api-reference/v1/openapi.json get /v1/filing/foreign-qualification/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
  - name: Filing
    description: Form a business, apply for an EIN, and register in additional states
  - name: Case
    description: Answer a request for information that a filing is waiting on
  - name: Registered Agent
    description: Registered agent service for a business
  - name: Documents
    description: Retrieve and download any document held for a business or a person
paths:
  /v1/filing/foreign-qualification/requirement:
    get:
      tags:
        - Filing
      summary: Get foreign qualification 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 what registering an existing business in a given state needs.
        Call this before building a request so you know what to collect.


        `schema` is a JSON Schema of the request body: the common fields plus
        the fields the state requires. Everything Palm reads from the referenced
        business (legal name, entity type, formation jurisdiction, formation
        date, registration number) is absent, since you never supply it.


        `prerequisites` lists the documents the state needs alongside the
        application, each with whether it is always required and who supplies
        it; Palm orders the home-state certificate as part of the filing.
        `signature_requirements` lists who must sign. `post_filing_obligations`
        lists what the registration starts once accepted. `channel` says whether
        the state files online or by mail, or is null when not yet known.


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


        Returns `501` for a state Palm does not yet support.
      operationId: getForeignQualificationRequirements
      parameters:
        - name: entity_type
          required: true
          in: query
          description: Entity type of the existing business
          schema:
            enum:
              - llc
              - professional_llc
              - corporation
              - professional_corporation
            type: string
        - name: jurisdiction
          required: true
          in: query
          description: The state to register in (e.g., US-TX)
          schema:
            type: string
      responses:
        '200':
          description: Foreign qualification requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilingRequirementResult'
        '501':
          description: The jurisdiction or entity type is not yet supported
      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
        prerequisites:
          description: >-
            Foreign qualification only: documents the target state needs
            alongside the application, each with whether it is always required
            and who supplies it. Empty when none have been captured for the
            state, which is not a claim that none are needed.
          type: array
          items:
            $ref: '#/components/schemas/FilingPrerequisite'
        signature_requirements:
          description: >-
            Foreign qualification only: signatures the state needs on the
            application.
          type: array
          items:
            $ref: '#/components/schemas/SignatureRequirement'
        post_filing_obligations:
          description: >-
            Foreign qualification only: obligations the registration starts once
            accepted.
          type: array
          items:
            $ref: '#/components/schemas/PostFilingObligation'
        channel:
          type: string
          description: >-
            Foreign qualification only: how the state accepts the application.
            Mail filings take longer and offer no expedited processing. Null
            when not yet known for the state.
          nullable: true
          enum:
            - online
            - mail
            - null
          example: online
        schema:
          type: object
          description: JSON Schema describing the request body for this filing.
          additionalProperties: true
          example:
            type: object
            required:
              - jurisdiction
              - legal_name
              - purpose
              - email
              - contact
              - principal_address
              - organizers
            properties:
              legal_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
    FilingPrerequisite:
      type: object
      properties:
        type:
          type: string
          description: Document the state needs.
          enum:
            - certificate_of_good_standing
            - certified_copy
            - registered_agent_consent
            - name_consent
            - fictitious_name_resolution
            - additional_provisions
            - other
          example: certificate_of_good_standing
        description:
          type: string
          description: What the state asks for, in its own words.
          example: >-
            A certificate of existence from the home jurisdiction, dated within
            six months of filing.
        required:
          type: boolean
          description: Whether the state always needs it.
          example: true
        condition:
          type: string
          nullable: true
          description: >-
            When the document is only needed in some situations, the situation
            in plain language. Null when it is always needed.
          example: null
        issuer:
          type: string
          nullable: true
          description: Who issues the document. Null when the filer writes it.
          example: Secretary of State of the home jurisdiction
        max_age:
          nullable: true
          description: >-
            Maximum age of the document at submission. Null when the state sets
            no limit.
          type: object
          allOf:
            - $ref: '#/components/schemas/DocumentMaxAge'
        accepted_formats:
          description: >-
            File formats the state accepts, as lowercase extensions. Empty when
            the state does not say.
          example:
            - pdf
          type: array
          items:
            type: string
        provided_by:
          type: string
          description: >-
            Who supplies the document. Palm orders the home-state certificate as
            part of the filing.
          enum:
            - palm
            - partner
          example: palm
      required:
        - type
        - description
        - required
        - condition
        - issuer
        - max_age
        - accepted_formats
        - provided_by
    SignatureRequirement:
      type: object
      properties:
        signer:
          type: string
          description: Who signs.
          enum:
            - incorporator
            - organizer
            - registered_agent
            - authorized_person
            - notary
            - officer
            - member
            - manager
            - director
            - attorney
            - other
          example: authorized_person
        description:
          type: string
          description: What the state asks for, in its own words.
          example: Signature of an authorized person of the foreign LLC
        cardinality:
          type: string
          description: How many of that role must sign.
          enum:
            - each
            - at_least_one
            - single
            - standalone
          example: at_least_one
        notarized:
          type: boolean
          description: Whether the signature must be notarized.
          example: false
      required:
        - signer
        - description
        - cardinality
        - notarized
    PostFilingObligation:
      type: object
      properties:
        type:
          type: string
          description: Obligation the registration starts.
          enum:
            - publication
            - initial_report
            - tax_registration
            - business_license
            - other
          example: publication
        description:
          type: string
          description: What the state asks for, in its own words.
          example: >-
            Publish a copy of the application in two newspapers within 120 days
            of filing.
        deadline:
          nullable: true
          description: When it is due. Null when the state fixes no deadline.
          type: object
          allOf:
            - $ref: '#/components/schemas/ObligationDeadline'
      required:
        - type
        - description
        - deadline
    DocumentMaxAge:
      type: object
      properties:
        value:
          type: number
          description: Number of units.
          example: 6
        unit:
          type: string
          description: Unit of the window.
          enum:
            - days
            - months
          example: months
      required:
        - value
        - unit
    ObligationDeadline:
      type: object
      properties:
        value:
          type: number
          description: Number of units.
          example: 120
        unit:
          type: string
          description: Unit of the window.
          enum:
            - days
            - months
          example: days
        from:
          type: string
          description: Event the window counts from.
          enum:
            - filing
            - approval
          example: filing
      required:
        - value
        - unit
        - from
  securitySchemes:
    ApiKey:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx'

````