> ## 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 business from registry

> Retrieve a detailed business record from the registry by jurisdiction and registration number. Returns a fuller record than search, including connected people (associates), standing, fictitious names, and industry codes.



## OpenAPI

````yaml /api-reference/v1/openapi.json get /v1/business/registry/{registration_jurisdiction}/{registration_number}
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/{registration_jurisdiction}/{registration_number}:
    get:
      tags:
        - Registry
      summary: Get business from registry
      description: >-
        Retrieve a detailed business record from the registry by jurisdiction
        and registration number. Returns a fuller record than search, including
        connected people (associates), standing, fictitious names, and industry
        codes.
      operationId: getBusinessFromRegistry
      parameters:
        - name: registration_jurisdiction
          required: true
          in: path
          description: Registration jurisdiction (e.g., US-CA, US-DE)
          schema:
            example: US-FL
            type: string
        - name: registration_number
          required: true
          in: path
          description: Registry-assigned registration/file number
          schema:
            example: '814956'
            type: string
      responses:
        '200':
          description: Business details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegistryBusinessDetail'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationProblemDetail'
        '404':
          description: Business not found in registry
        '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:
    RegistryBusinessDetail:
      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'
        identifier:
          description: >-
            Additional public, cross-registry identifiers. Only identifiers
            present on the record are included.
          allOf:
            - $ref: '#/components/schemas/RegistryIdentifier'
        standing:
          description: Compliance standing with state agencies
          allOf:
            - $ref: '#/components/schemas/StandingResponse'
      required:
        - palm_id
        - name
        - formation_date
        - fictitious_names
        - industry_codes
        - associates
    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
    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
    RegistryIdentifier:
      type: object
      properties:
        lei:
          type: string
          example: UWJKFUJFZ02DKWI3RY53
          description: >-
            Legal Entity Identifier (ISO 17442) — 20-character globally unique
            code issued by GLEIF.
        sec_cik:
          type: string
          example: '0000141617'
          description: >-
            SEC EDGAR Central Index Key (zero-padded 10-digit) for entities that
            file with the SEC.
        business_number:
          type: string
          example: 774955926RC0001
          description: >-
            Canada Revenue Agency Business Number (BN15) for Canadian
            businesses.
        state_tax_id:
          type: string
          example: '32005739365'
          description: >-
            State taxpayer/registration number issued by the jurisdiction
            (distinct from the federal EIN).
        duns:
          type: string
          example: '150483782'
          description: Dun & Bradstreet DUNS number.
        vat:
          type: string
          example: GB123456789
          description: Value-added tax (VAT) registration number.
    StandingResponse:
      type: object
      properties:
        registration:
          type: string
          example: compliant
          enum:
            - compliant
            - not_compliant
          nullable: true
          description: Registration standing with the state registry
        tax:
          type: string
          example: compliant
          enum:
            - compliant
            - not_compliant
          nullable: true
          description: Tax standing (franchise tax, etc.)
        agent:
          type: string
          example: compliant
          enum:
            - compliant
            - not_compliant
          nullable: true
          description: Registered agent standing
  securitySchemes:
    ApiKey:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx'

````