> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decodahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lookup Modifiers

> Resolve an explicit set of modifier codes to their descriptions.

Backs the printed Super Bill and note, which persist modifiers as bare codes
(e.g. "25") and need the label ("Significant, separately identifiable...")
to print beside them. This is an exact batch lookup rather than a reuse of
``/modifiers/search`` because the print paths already know exactly which
codes are on the document, and ``modifier`` is ~308 rows against that
endpoint's 100-row cap — so paging the whole table to build a code -> label
map is not an option.

Codes are matched upper-cased (``modifier.code`` is stored that way, so a
free-typed lower-case modifier still resolves) against the primary key.
Unknown codes are simply absent from the response — the caller prints the
bare code, which is what a superbill did before this endpoint existed.



## OpenAPI

````yaml get /medical-codes/modifiers/lookup
openapi: 3.1.0
info:
  title: Decoda API
  description: External API documentation for the Decoda Health platform.
  version: '1.0'
servers: []
security: []
paths:
  /medical-codes/modifiers/lookup:
    get:
      tags:
        - Medical Codes
      summary: Lookup Modifiers
      description: >-
        Resolve an explicit set of modifier codes to their descriptions.


        Backs the printed Super Bill and note, which persist modifiers as bare
        codes

        (e.g. "25") and need the label ("Significant, separately
        identifiable...")

        to print beside them. This is an exact batch lookup rather than a reuse
        of

        ``/modifiers/search`` because the print paths already know exactly which

        codes are on the document, and ``modifier`` is ~308 rows against that

        endpoint's 100-row cap — so paging the whole table to build a code ->
        label

        map is not an option.


        Codes are matched upper-cased (``modifier.code`` is stored that way, so
        a

        free-typed lower-case modifier still resolves) against the primary key.

        Unknown codes are simply absent from the response — the caller prints
        the

        bare code, which is what a superbill did before this endpoint existed.
      operationId: lookup_modifiers_medical_codes_modifiers_lookup_get
      parameters:
        - name: TENANT
          in: header
          required: true
          schema:
            type: string
            title: Tenant
          description: The tenant you are making this request on behalf of
        - name: API-KEY
          in: header
          required: true
          schema:
            type: string
            title: Api-Key
          description: Your api key
        - name: codes
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: Modifier codes to resolve; repeat the param once per code
            title: Codes
          description: Modifier codes to resolve; repeat the param once per code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ModifierCode'
                title: Response Lookup Modifiers Medical Codes Modifiers Lookup Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ModifierCode:
      properties:
        code:
          type: string
          title: Code
        description:
          type: string
          title: Description
      type: object
      required:
        - code
        - description
      title: ModifierCode
      description: >-
        A billing modifier from the canonical ``modifier`` reference table — its

        ``code`` plus the modifier ``description``. Backs the Super Bill
        editor's

        browsable modifier search.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````