US Senate Lobbying Disclosure Act (LDA) API — Constants

naftiko: 1.0.0-alpha2
info:
  label: US Senate Lobbying Disclosure Act (LDA) API — Constants
  description: 'US Senate Lobbying Disclosure Act (LDA) API — Constants. 5 operations. Lead operation: Get Filing Type Codes.
    Self-contained Naftiko capability covering one Us Senate business surface.'
  tags:
  - Us Senate
  - Constants
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    US_SENATE_API_KEY: US_SENATE_API_KEY
capability:
  consumes:
  - type: http
    namespace: lda-constants
    baseUri: https://lda.senate.gov/api/v1
    description: US Senate Lobbying Disclosure Act (LDA) API — Constants business capability. Self-contained, no shared references.
    resources:
    - name: constants-filing-filingtypes
      path: /constants/filing/filingtypes/
      operations:
      - name: getfilingtypes
        method: GET
        description: Get Filing Type Codes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: format
          in: query
          type: string
    - name: constants-filing-governmententities
      path: /constants/filing/governmententities/
      operations:
      - name: getgovernmententities
        method: GET
        description: Get Government Entity Codes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: format
          in: query
          type: string
    - name: constants-filing-lobbyingactivityissues
      path: /constants/filing/lobbyingactivityissues/
      operations:
      - name: getlobbyingissues
        method: GET
        description: Get Lobbying Activity Issue Codes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: format
          in: query
          type: string
    - name: constants-general-countries
      path: /constants/general/countries/
      operations:
      - name: getcountries
        method: GET
        description: Get Country Codes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: constants-general-states
      path: /constants/general/states/
      operations:
      - name: getstates
        method: GET
        description: Get US State Codes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.US_SENATE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: lda-constants-rest
    port: 8080
    description: REST adapter for US Senate Lobbying Disclosure Act (LDA) API — Constants. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/constants/filing/filingtypes
      name: constants-filing-filingtypes
      description: REST surface for constants-filing-filingtypes.
      operations:
      - method: GET
        name: getfilingtypes
        description: Get Filing Type Codes
        call: lda-constants.getfilingtypes
        with:
          format: rest.format
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/constants/filing/governmententities
      name: constants-filing-governmententities
      description: REST surface for constants-filing-governmententities.
      operations:
      - method: GET
        name: getgovernmententities
        description: Get Government Entity Codes
        call: lda-constants.getgovernmententities
        with:
          format: rest.format
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/constants/filing/lobbyingactivityissues
      name: constants-filing-lobbyingactivityissues
      description: REST surface for constants-filing-lobbyingactivityissues.
      operations:
      - method: GET
        name: getlobbyingissues
        description: Get Lobbying Activity Issue Codes
        call: lda-constants.getlobbyingissues
        with:
          format: rest.format
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/constants/general/countries
      name: constants-general-countries
      description: REST surface for constants-general-countries.
      operations:
      - method: GET
        name: getcountries
        description: Get Country Codes
        call: lda-constants.getcountries
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/constants/general/states
      name: constants-general-states
      description: REST surface for constants-general-states.
      operations:
      - method: GET
        name: getstates
        description: Get US State Codes
        call: lda-constants.getstates
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: lda-constants-mcp
    port: 9090
    transport: http
    description: MCP adapter for US Senate Lobbying Disclosure Act (LDA) API — Constants. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: get-filing-type-codes
      description: Get Filing Type Codes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lda-constants.getfilingtypes
      with:
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.
    - name: get-government-entity-codes
      description: Get Government Entity Codes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lda-constants.getgovernmententities
      with:
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.
    - name: get-lobbying-activity-issue-codes
      description: Get Lobbying Activity Issue Codes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lda-constants.getlobbyingissues
      with:
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.
    - name: get-country-codes
      description: Get Country Codes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lda-constants.getcountries
      outputParameters:
      - type: object
        mapping: $.
    - name: get-us-state-codes
      description: Get US State Codes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lda-constants.getstates
      outputParameters:
      - type: object
        mapping: $.