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

# Validate a foreign qualification request

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

Check a foreign qualification payload without creating a filing or business record. Runs the same checks as the create endpoint except the name check, and returns every finding in one pass: problems with the referenced business record (missing fields, not the formation-state registration, already registered in the target state), an expedited tier the state does not offer, and state compliance errors on the payload.

Accepts a partial or complete payload, including the same state-specific fields as the create endpoint. Any top-level field the state does not accept is reported under `warnings`; those are dropped rather than rejected when you create the filing.

The name check runs only on the create endpoint, so a payload that passes here can still be rejected there because the legal name is unavailable in the target state.



## OpenAPI

````yaml /api-reference/v1/openapi.json post /v1/filing/foreign-qualification/validate
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/validate:
    post:
      tags:
        - Filing
      summary: Validate a foreign qualification request
      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.


        Check a foreign qualification payload without creating a filing or
        business record. Runs the same checks as the create endpoint except the
        name check, and returns every finding in one pass: problems with the
        referenced business record (missing fields, not the formation-state
        registration, already registered in the target state), an expedited tier
        the state does not offer, and state compliance errors on the payload.


        Accepts a partial or complete payload, including the same state-specific
        fields as the create endpoint. Any top-level field the state does not
        accept is reported under `warnings`; those are dropped rather than
        rejected when you create the filing.


        The name check runs only on the create endpoint, so a payload that
        passes here can still be rejected there because the legal name is
        unavailable in the target state.
      operationId: validateForeignQualification
      parameters: []
      responses:
        '200':
          description: Validation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResult'
        '501':
          description: The target state is not yet supported
      security:
        - ApiKey: []
components:
  schemas:
    ValidationResult:
      type: object
      properties:
        valid:
          type: boolean
          description: True when the payload passed every compliance check
        errors:
          description: All compliance errors found, empty when valid
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
        warnings:
          description: >-
            Non-blocking observations: a top-level field this jurisdiction does
            not accept (UNKNOWN_FIELD), an EIN field the business's entity type
            is never asked (NOT_APPLICABLE), or a declared LLC member count that
            disagrees with the listed members (MEMBER_COUNT_MISMATCH). None of
            these rejects the create — the field is ignored or filed as declared
            — so this is the only place they surface. Empty when there is
            nothing to report.
          type: array
          items:
            $ref: '#/components/schemas/ValidationWarning'
      required:
        - valid
        - errors
        - warnings
    ValidationError:
      type: object
      properties:
        source:
          type: string
          description: Error origin
          example: jsonschema
        code:
          type: string
          description: Machine-readable error code
          example: JSONSCHEMA_VALIDATION_FAILED
        path:
          type: string
          description: Dotted path into the request body
          example: jurisdiction_registered_agent.agent_type
        message:
          type: string
          description: Human-readable message
      required:
        - source
        - code
        - path
        - message
    ValidationWarning:
      type: object
      properties:
        source:
          type: string
          description: Warning origin
          example: payload
        code:
          type: string
          description: Machine-readable warning code
          example: UNKNOWN_FIELD
        path:
          type: string
          description: Dotted path into the request body
          example: initial_board_size
        message:
          type: string
          description: Human-readable message
      required:
        - source
        - code
        - path
        - message
  securitySchemes:
    ApiKey:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx'

````