BankruptcyWatch PACER API — Cases

naftiko: 1.0.0-alpha2
info:
  label: BankruptcyWatch PACER API — Cases
  description: 'BankruptcyWatch PACER API — Cases. 2 operations. Lead operation: Search Bankruptcy Cases. Self-contained Naftiko
    capability covering one Bankruptcywatch business surface.'
  tags:
  - Bankruptcywatch
  - Cases
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    BANKRUPTCYWATCH_API_KEY: BANKRUPTCYWATCH_API_KEY
capability:
  consumes:
  - type: http
    namespace: pacer-cases
    baseUri: https://api.bankruptcywatch.com/v1
    description: BankruptcyWatch PACER API — Cases business capability. Self-contained, no shared references.
    resources:
    - name: cases-search
      path: /cases/search
      operations:
      - name: searchcases
        method: GET
        description: Search Bankruptcy Cases
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: debtorName
          in: query
          type: string
          description: Debtor name to search for
        - name: caseNumber
          in: query
          type: string
          description: PACER case number
        - name: district
          in: query
          type: string
          description: Bankruptcy court district code
        - name: chapter
          in: query
          type: string
          description: Bankruptcy chapter (7, 11, 13, etc.)
        - name: dateFiledFrom
          in: query
          type: string
          description: Filter cases filed on or after this date (ISO 8601)
        - name: dateFiledTo
          in: query
          type: string
          description: Filter cases filed on or before this date (ISO 8601)
        - name: status
          in: query
          type: string
          description: Case status filter (open, closed, discharged)
    - name: cases-caseId
      path: /cases/{caseId}
      operations:
      - name: getcase
        method: GET
        description: Get Case Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: caseId
          in: path
          type: string
          description: BankruptcyWatch case identifier
          required: true
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.BANKRUPTCYWATCH_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: pacer-cases-rest
    port: 8080
    description: REST adapter for BankruptcyWatch PACER API — Cases. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/cases/search
      name: cases-search
      description: REST surface for cases-search.
      operations:
      - method: GET
        name: searchcases
        description: Search Bankruptcy Cases
        call: pacer-cases.searchcases
        with:
          debtorName: rest.debtorName
          caseNumber: rest.caseNumber
          district: rest.district
          chapter: rest.chapter
          dateFiledFrom: rest.dateFiledFrom
          dateFiledTo: rest.dateFiledTo
          status: rest.status
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cases/{caseid}
      name: cases-caseid
      description: REST surface for cases-caseId.
      operations:
      - method: GET
        name: getcase
        description: Get Case Details
        call: pacer-cases.getcase
        with:
          caseId: rest.caseId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: pacer-cases-mcp
    port: 9090
    transport: http
    description: MCP adapter for BankruptcyWatch PACER API — Cases. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: search-bankruptcy-cases
      description: Search Bankruptcy Cases
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pacer-cases.searchcases
      with:
        debtorName: tools.debtorName
        caseNumber: tools.caseNumber
        district: tools.district
        chapter: tools.chapter
        dateFiledFrom: tools.dateFiledFrom
        dateFiledTo: tools.dateFiledTo
        status: tools.status
      outputParameters:
      - type: object
        mapping: $.
    - name: get-case-details
      description: Get Case Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pacer-cases.getcase
      with:
        caseId: tools.caseId
      outputParameters:
      - type: object
        mapping: $.