> ## 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 accepted name designators

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

List the name designators (also called suffixes) a jurisdiction accepts for each entity type — the `LLC`, `Inc.`, or `P.C.` a business name must carry to be filed there.

Call this before collecting a name so you can offer the valid designators up front, or append one on the user's behalf, rather than discovering the requirement from a rejected name. Omit `entity_type` to receive every entity type in one response.

A few jurisdictions mandate no designator for an entity type (California corporations, for one). Those return `required: false` with an empty `accepted` list, meaning a name may be filed with or without one.

Designators are one of several naming requirements. A name carrying a valid designator can still be rejected for other reasons, so check the finished name with the name-eligibility endpoint before filing.



## OpenAPI

````yaml /api-reference/v1/openapi.json get /v1/business/registry/{registration_jurisdiction}/name-eligibility/designator
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
paths:
  /v1/business/registry/{registration_jurisdiction}/name-eligibility/designator:
    get:
      tags:
        - Registry
      summary: Get accepted name designators
      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.


        List the name designators (also called suffixes) a jurisdiction accepts
        for each entity type — the `LLC`, `Inc.`, or `P.C.` a business name must
        carry to be filed there.


        Call this before collecting a name so you can offer the valid
        designators up front, or append one on the user's behalf, rather than
        discovering the requirement from a rejected name. Omit `entity_type` to
        receive every entity type in one response.


        A few jurisdictions mandate no designator for an entity type (California
        corporations, for one). Those return `required: false` with an empty
        `accepted` list, meaning a name may be filed with or without one.


        Designators are one of several naming requirements. A name carrying a
        valid designator can still be rejected for other reasons, so check the
        finished name with the name-eligibility endpoint before filing.
      operationId: getNameDesignators
      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: entity_type
          required: false
          in: query
          description: Limit the response to one entity type. Omit to receive all of them.
          schema:
            enum:
              - llc
              - professional_llc
              - corporation
              - professional_corporation
            type: string
      responses:
        '200':
          description: Accepted designators returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NameDesignatorResult'
        '400':
          description: Invalid jurisdiction 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:
    NameDesignatorResult:
      type: object
      properties:
        jurisdiction:
          type: string
          description: Jurisdiction the designators apply to (ISO 3166-2)
          example: US-TX
        designators:
          description: >-
            Accepted designators per entity type, one entry per entity type
            requested
          type: array
          items:
            $ref: '#/components/schemas/NameDesignator'
      required:
        - jurisdiction
        - designators
    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
    NameDesignator:
      type: object
      properties:
        entity_type:
          type: string
          description: Entity type the designators apply to
          enum:
            - llc
            - professional_llc
            - corporation
            - professional_corporation
          example: llc
        required:
          type: boolean
          description: >-
            True when the jurisdiction requires the name to carry one of the
            accepted designators. False when the jurisdiction mandates none for
            this entity type, in which case `accepted` is empty and any
            compliant name may be filed with or without a designator.
          example: true
        accepted:
          description: >-
            Designators the jurisdiction accepts, in statute order. A name
            satisfies the requirement when it ends with any one of them. Empty
            when `required` is false.
          example:
            - LLC
            - L.L.C.
            - Limited Liability Company
          type: array
          items:
            type: string
        recommended:
          type: string
          description: >-
            The most conventional accepted designator, offered as a default when
            you append one on the user’s behalf. Null when the jurisdiction
            requires none.
          nullable: true
          example: LLC
      required:
        - entity_type
        - required
        - accepted
        - recommended
    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'

````