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

# Search business registries

> Search business registries to find registered businesses before verifying them. Records are drawn from authoritative sources — state registries, the IRS, and licensing agencies. Returns each match with its Palm ID, registration details (legal name, entity type, registration number, formation date, jurisdictions, and current status), and principal address.



## OpenAPI

````yaml /api-reference/v1/openapi.json post /v1/business/registry/search
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: Verification
    description: Identity and business verification
  - name: Monitor
    description: Continuous monitoring of businesses
  - name: Business
    description: Business entity management
  - name: User
    description: User identity management
paths:
  /v1/business/registry/search:
    post:
      tags:
        - Registry
      summary: Search business registries
      description: >-
        Search business registries to find registered businesses before
        verifying them. Records are drawn from authoritative sources — state
        registries, the IRS, and licensing agencies. Returns each match with its
        Palm ID, registration details (legal name, entity type, registration
        number, formation date, jurisdictions, and current status), and
        principal address.
      operationId: searchBusinessRegistry
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessRegistrySearchRequest'
      responses:
        '200':
          description: Search results returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    example: list
                  data:
                    type: array
                    description: >-
                      Response format depends on your account configuration.
                      Contact support@getpalm.com if you have questions.
                    items:
                      oneOf:
                        - $ref: '#/components/schemas/RegistrySearchResult'
                          title: Default
                        - $ref: '#/components/schemas/RegistrySearchExpandedResult'
                          title: Expanded Result
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetail'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationProblemDetail'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitProblemDetail'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorProblemDetail'
      security:
        - ApiKey: []
components:
  schemas:
    BusinessRegistrySearchRequest:
      type: object
      properties:
        name:
          type: string
          description: >-
            Business name to search. Required when neither associate.name nor
            palm_id is provided.
          example: The Coca-Cola Company
        associate:
          description: >-
            Search by an associated person or organization (officer, director,
            manager, member, or registered agent). Required when neither name
            nor palm_id is provided.
          allOf:
            - $ref: '#/components/schemas/RegistryAssociateSearch'
        palm_id:
          type: string
          description: >-
            Palm ID of a specific registry business. When provided, returns that
            record directly without name-based matching.
          example: 4604-3477-1850
        registration_jurisdiction:
          type: string
          example: US-FL
          description: >-
            Registration jurisdiction in ISO 3166-2 format (e.g., US-CA, US-NY,
            US-TX)
        formation_jurisdiction:
          type: string
          example: US-DE
          description: >-
            Formation jurisdiction in ISO 3166-2 format (e.g., US-DE, US-CA,
            US-WY)
        location_street:
          type: string
          description: Street address where business is physically located
          example: One Coca-Cola Plaza NW
        location_city:
          type: string
          description: City where business is physically located
          example: Atlanta
        location_region:
          type: string
          description: >-
            Region/state/province where business is physically located (ISO
            3166-2 format: XX-YY)
          example: US-GA
        location_postal_code:
          type: string
          description: Postal/ZIP code where business is physically located
          example: '30313'
        entity_type:
          type: string
          description: Entity type
          example: corporation
          enum:
            - corporation
            - llc
            - lp
            - llp
            - nonprofit
        status:
          type: string
          description: Business status
          example: active
          enum:
            - active
            - inactive
            - dissolved
            - expired
            - merged
            - withdrawn
            - pending
            - canceled
        formation_date:
          description: >-
            Filter by business formation date (inclusive range). Either bound is
            optional.
          allOf:
            - $ref: '#/components/schemas/DateRange'
    RegistrySearchResult:
      type: object
      properties:
        palm_id:
          type: string
          example: 2735-1926-5317
          description: Unique Palm business identifier
        name:
          type: string
          example: THE COCA-COLA COMPANY
          nullable: true
          description: Business legal name
        formation_jurisdiction:
          type: string
          example: US-DE
          nullable: true
          description: Jurisdiction where the business was originally formed (US-XX format)
        registration_jurisdiction:
          type: string
          example: US-FL
          nullable: true
          description: >-
            Jurisdiction where the business is registered to operate (US-XX
            format)
        status:
          type: string
          example: active
          nullable: true
          enum:
            - active
            - inactive
            - dissolved
            - expired
            - merged
            - withdrawn
            - pending
            - canceled
          description: Current business status from the registry record
        entity_type:
          type: string
          example: corporation
          nullable: true
          enum:
            - llc
            - corporation
            - lp
            - llp
            - nonprofit
            - other
          description: Type of business entity
        formation_date:
          type: string
          format: date
          example: '1961-01-03'
          nullable: true
          description: Date the business was formed (YYYY-MM-DD)
        registration_number:
          type: string
          example: '814956'
          description: Registry-assigned registration/file number
        principal_address:
          description: Principal place of business address
          allOf:
            - $ref: '#/components/schemas/Address'
      required:
        - palm_id
        - name
        - formation_date
    RegistrySearchExpandedResult:
      type: object
      properties:
        palm_id:
          type: string
          example: 2735-1926-5317
          description: Unique Palm business identifier
        name:
          type: string
          example: THE COCA-COLA COMPANY
          nullable: true
          description: Business legal name
        formation_jurisdiction:
          type: string
          example: US-DE
          nullable: true
          description: Jurisdiction where the business was originally formed (US-XX format)
        registration_jurisdiction:
          type: string
          example: US-FL
          nullable: true
          description: >-
            Jurisdiction where the business is registered to operate (US-XX
            format)
        status:
          type: string
          example: active
          nullable: true
          enum:
            - active
            - inactive
            - dissolved
            - expired
            - merged
            - withdrawn
            - pending
            - canceled
          description: Current business status from the registry record
        entity_type:
          type: string
          example: corporation
          nullable: true
          enum:
            - llc
            - corporation
            - lp
            - llp
            - nonprofit
            - other
          description: Type of business entity
        formation_date:
          type: string
          format: date
          example: '1961-01-03'
          nullable: true
          description: Date the business was formed (YYYY-MM-DD)
        registration_number:
          type: string
          example: '814956'
          description: Registry-assigned registration/file number
        principal_address:
          description: Principal place of business address
          allOf:
            - $ref: '#/components/schemas/Address'
        mailing_address:
          description: Mailing address
          allOf:
            - $ref: '#/components/schemas/Address'
        fictitious_names:
          example: []
          description: List of fictitious/DBA names
          type: array
          items:
            type: string
        industry_codes:
          description: Industry classification codes (NAICS, SIC)
          type: array
          items:
            $ref: '#/components/schemas/IndustryCode'
        associates:
          description: Officers, directors, agents, and other associates
          type: array
          items:
            $ref: '#/components/schemas/AssociateResponse'
      required:
        - palm_id
        - name
        - formation_date
        - fictitious_names
        - industry_codes
        - associates
    ValidationProblemDetail:
      type: object
      properties:
        type:
          type: string
          example: https://api.getpalm.com/problems/validation_error
        title:
          type: string
          example: Validation Error
        status:
          type: number
          example: 400
        detail:
          type: string
          example: Request validation failed
        instance:
          type: string
          example: /business/registry/search
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorField'
      required:
        - type
        - title
        - status
        - detail
        - instance
        - errors
    AuthenticationProblemDetail:
      type: object
      properties:
        type:
          type: string
          example: https://api.getpalm.com/problems/authentication_error
        title:
          type: string
          example: Unauthorized
        status:
          type: number
          example: 401
        detail:
          type: string
          example: >-
            No valid authentication provided. Please provide one of the accepted
            authentication methods.
        instance:
          type: string
          example: /business/registry/search
      required:
        - type
        - title
        - status
        - detail
        - instance
    RateLimitProblemDetail:
      type: object
      properties:
        type:
          type: string
          example: https://api.getpalm.com/problems/rate_limit_exceeded
        title:
          type: string
          example: Too Many Requests
        status:
          type: number
          example: 429
        detail:
          type: string
          example: Rate limit exceeded. Please retry after 60 seconds.
        instance:
          type: string
          example: /business/registry/search
        retry_after:
          type: number
          example: 60
        limit:
          type: number
          example: 100000
        remaining:
          type: number
          example: 0
        reset:
          type: number
          example: 1738540800
      required:
        - type
        - title
        - status
        - detail
        - instance
    InternalErrorProblemDetail:
      type: object
      properties:
        type:
          type: string
          example: https://api.getpalm.com/problems/internal_error
        title:
          type: string
          example: Internal Server Error
        status:
          type: number
          example: 500
        detail:
          type: string
          example: >-
            An internal server error occurred. Please contact support if this
            persists.
        instance:
          type: string
          example: /business/registry/search
      required:
        - type
        - title
        - status
        - detail
        - instance
    RegistryAssociateSearch:
      type: object
      properties:
        name:
          type: string
          description: >-
            Name of a person or organization associated with a business
            (officer, director, manager, member, or registered agent). Returns
            every registered business that party is connected to. Combine with
            location or jurisdiction filters to narrow results for common names.
          example: Jane Doe
      required:
        - name
    DateRange:
      type: object
      properties:
        from:
          type: string
          description: Inclusive lower bound (ISO-8601 date or datetime)
          example: '2026-03-23'
        to:
          type: string
          description: Inclusive upper bound (ISO-8601 date or datetime)
          example: '2026-04-22'
    Address:
      type: object
      properties:
        street_line_1:
          type: string
          example: One Coca-Cola Plaza NW
          description: Street address line 1
        street_line_2:
          type: string
          example: Suite 200
          description: Street address line 2 (apt, suite, etc.)
        city:
          type: string
          example: Atlanta
          description: City
        region:
          type: string
          example: GA
          description: State or region code
        postal_code:
          type: string
          example: '30313'
          description: Postal/ZIP code
        country:
          type: string
          example: US
          description: Country code
      required:
        - country
    IndustryCode:
      type: object
      properties:
        code:
          type: string
          example: '312111'
          description: Industry classification code
        type:
          type: string
          example: naics
          enum:
            - naics
            - sic
            - other
          description: Classification system type
        description:
          type: string
          example: Soft Drink Manufacturing
          description: Description of the industry code
      required:
        - code
        - type
    AssociateResponse:
      type: object
      properties:
        role:
          type: string
          example: agent
          enum:
            - agent
            - manager
            - officer
            - director
            - member
            - organizer
          description: Role of the associate in the business
        name:
          type: string
          example: CT Corporation System
          nullable: true
          description: Name of the associate
        title:
          type: string
          example: Registered Agent
          description: Title or position
        type:
          type: string
          example: organization
          enum:
            - person
            - organization
          description: Type of associate
        address:
          description: Address of the associate
          allOf:
            - $ref: '#/components/schemas/Address'
      required:
        - role
        - name
        - type
    ValidationErrorField:
      type: object
      properties:
        field:
          type: string
          example: name
          description: Field name that failed validation
        message:
          type: string
          example: name should not be empty
          description: Validation error message
        code:
          type: string
          example: NOT_EMPTY
          description: Error code
      required:
        - field
        - message
  securitySchemes:
    ApiKey:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx'

````