> ## 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. # Check business name eligibility > > **⚠️ 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 whether a prospective business name can be registered in a jurisdiction before filing a formation. Combines the jurisdiction's naming rules (required designators, prohibited and restricted words, character limits) with registry availability. Returns a single `eligible` answer plus `violations` explaining any naming-rule problems and `corrections` for a fixable name. Pass `suggest=true` to also receive alternative name ideas in `alternatives`. ## OpenAPI ````yaml /api-reference/v1/openapi.json get /v1/business/registry/{registration_jurisdiction}/name-eligibility 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}/name-eligibility: get: tags: - Registry summary: Check business name eligibility 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 whether a prospective business name can be registered in a jurisdiction before filing a formation. Combines the jurisdiction's naming rules (required designators, prohibited and restricted words, character limits) with registry availability. Returns a single `eligible` answer plus `violations` explaining any naming-rule problems and `corrections` for a fixable name. Pass `suggest=true` to also receive alternative name ideas in `alternatives`. operationId: checkNameEligibility parameters: - name: registration_jurisdiction required: true in: path description: US jurisdiction (ISO 3166-2), e.g., US-TX schema: example: US-TX type: string - name: name required: true in: query description: Prospective business name to check schema: example: Maple Street Ventures LLC type: string - name: entity_type required: true in: query description: Entity type to check the name against schema: enum: - llc - pllc - corporation - pcorporation type: string - name: suggest required: false in: query description: >- Return alternative name suggestions. Note: this increases response time. schema: example: false type: boolean - name: screen required: false in: query description: >- Screen the name for content issues (obscenity, deceptive agency similarity). Note: this increases response time. schema: example: false type: boolean responses: '200': description: Eligibility result returned successfully content: application/json: schema: $ref: '#/components/schemas/NameEligibilityResult' '400': description: Invalid jurisdiction, name, or entity_type 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: NameEligibilityResult: type: object properties: eligible: type: boolean description: True when the name is both compliant with naming rules and available compliant: type: boolean description: True when the name has no hard naming-rule violations violations: description: Naming-rule violations, empty when compliant type: array items: $ref: '#/components/schemas/NameRuleViolation' available: type: boolean description: True when no active registered business holds this exact name corrections: description: >- Deterministic, eligible fixes to the submitted name (e.g. a missing designator) type: array items: $ref: '#/components/schemas/NameCorrection' alternatives: description: Eligible alternative names (only when `suggest=true`) example: - Maple Street Holdings LLC type: array items: type: string required: - eligible - compliant - violations - available - corrections - alternatives 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 NameRuleViolation: type: object properties: rule: type: string description: The naming rule that was violated example: required_designator severity: type: string description: >- `error` blocks registration; `needs_approval` means the name is usable only with agency sign-off; `advisory` is a softer content-screening concern enum: - error - needs_approval - advisory example: error message: type: string description: Plain-language explanation and how to fix it example: >- Texas LLC names must end with an accepted designator such as 'LLC' or 'Limited Liability Company'. statute: type: string description: Controlling statute, when the source data documents one example: D.C. Code 29-103.02 required: - rule - severity - message NameCorrection: type: object properties: name: type: string description: The corrected name (compliant and available) reason: type: string description: What was fixed enum: - append_designator - fix_designator_typo example: append_designator message: type: string description: Plain-language description of the fix example: Add the required 'LLC' designator. required: - name - reason - message 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' ````