GovInfo API — Published

naftiko: 1.0.0-alpha2
info:
  label: GovInfo API — Published
  description: 'GovInfo API — Published. 2 operations. Lead operation: Retrieve list of packages based on dateIssued value.
    Self-contained Naftiko capability covering one Govinfo business surface.'
  tags:
  - Govinfo
  - Published
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GOVINFO_API_KEY: GOVINFO_API_KEY
capability:
  consumes:
  - type: http
    namespace: openapi-published
    baseUri: https://api.govinfo.gov
    description: GovInfo API — Published business capability. Self-contained, no shared references.
    resources:
    - name: published-dateIssuedStartDate
      path: /published/{dateIssuedStartDate}
      operations:
      - name: getpackagesbydateissued
        method: GET
        description: Retrieve list of packages based on dateIssued value
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dateIssuedStartDate
          in: path
          type: string
          description: The earliest dateIssued requested - YYYY-MM-DD
          required: true
        - name: offsetMark
          in: query
          type: string
          description: Indicates starting record for a given request. Use in conjunction with pageSize to paginate through
            the results. For the first request, use * - for subsequent r
        - name: offset
          in: query
          type: integer
          description: This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated
            and will be removed in the future. Please begin tra
        - name: pageSize
          in: query
          type: integer
          description: The number of records to return for a given request. Max value is 1000
          required: true
        - name: collection
          in: query
          type: string
          description: comma-separated list of collections that you are requesting, e.g. https://api.govinfo.gov/published/2019-01-01/2019-12-31?offset=0&pageSize=100&collection=BILLS
          required: true
        - name: congress
          in: query
          type: string
          description: congress number (e.g. 116)
        - name: docClass
          in: query
          type: string
          description: Filter the results by overarching collection-specific categories. The values vary from collection to
            collection. For example, docClass in BILLS corresponds with
        - name: billVersion
          in: query
          type: string
          description: Filter the results by overarching collection-specific categories.
        - name: modifiedSince
          in: query
          type: string
          description: 'equivalent to the lastModifiedStartDate parameter in the collections service which is based on lastModified-
            allows you to request only packages that have been '
        - name: courtCode
          in: query
          type: string
        - name: courtType
          in: query
          type: string
        - name: state
          in: query
          type: string
        - name: topic
          in: query
          type: string
        - name: isGLP
          in: query
          type: boolean
        - name: natureSuitCode
          in: query
          type: string
        - name: natureSuit
          in: query
          type: string
    - name: published-dateIssuedStartDate-dateIssuedEndDate
      path: /published/{dateIssuedStartDate}/{dateIssuedEndDate}
      operations:
      - name: getpackagesbydateissued1
        method: GET
        description: Retrieve list of packages based on dateIssued value range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dateIssuedStartDate
          in: path
          type: string
          description: The earliest dateIssued requested - YYYY-MM-DD
          required: true
        - name: dateIssuedEndDate
          in: path
          type: string
          description: The last dateIssued requested - YYYY-MM-DD
          required: true
        - name: offsetMark
          in: query
          type: string
          description: Indicates starting record for a given request. Use in conjunction with pageSize to paginate through
            the results. For the first request, use * - for subsequent r
        - name: offset
          in: query
          type: integer
          description: This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated
            and will be removed in the future. Please begin tra
        - name: pageSize
          in: query
          type: integer
          description: The number of records to return for a given request. Max value is 1000
          required: true
        - name: collection
          in: query
          type: string
          description: comma-separated list of collections that you are requesting, e.g. https://api.govinfo.gov/published/2019-01-01/2019-12-31?offset=0&pageSize=100&collection=BILLS
          required: true
        - name: congress
          in: query
          type: string
          description: congress number (e.g. 116)
        - name: docClass
          in: query
          type: string
          description: Filter the results by overarching collection-specific categories. The values vary from collection to
            collection. For example, docClass in BILLS corresponds with
        - name: billVersion
          in: query
          type: string
          description: Filter the results by overarching collection-specific categories.
        - name: modifiedSince
          in: query
          type: string
          description: 'equivalent to the lastModifiedStartDate parameter in the collections service which is based on lastModified-
            allows you to request only packages that have been '
        - name: courtCode
          in: query
          type: string
        - name: courtType
          in: query
          type: string
        - name: state
          in: query
          type: string
        - name: topic
          in: query
          type: string
        - name: natureSuitCode
          in: query
          type: string
        - name: natureSuit
          in: query
          type: string
        - name: isGLP
          in: query
          type: boolean
    authentication:
      type: apikey
      key: api_key
      value: '{{env.GOVINFO_API_KEY}}'
      placement: query
  exposes:
  - type: rest
    namespace: openapi-published-rest
    port: 8080
    description: REST adapter for GovInfo API — Published. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/published/{dateissuedstartdate}
      name: published-dateissuedstartdate
      description: REST surface for published-dateIssuedStartDate.
      operations:
      - method: GET
        name: getpackagesbydateissued
        description: Retrieve list of packages based on dateIssued value
        call: openapi-published.getpackagesbydateissued
        with:
          dateIssuedStartDate: rest.dateIssuedStartDate
          offsetMark: rest.offsetMark
          offset: rest.offset
          pageSize: rest.pageSize
          collection: rest.collection
          congress: rest.congress
          docClass: rest.docClass
          billVersion: rest.billVersion
          modifiedSince: rest.modifiedSince
          courtCode: rest.courtCode
          courtType: rest.courtType
          state: rest.state
          topic: rest.topic
          isGLP: rest.isGLP
          natureSuitCode: rest.natureSuitCode
          natureSuit: rest.natureSuit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/published/{dateissuedstartdate}/{dateissuedenddate}
      name: published-dateissuedstartdate-dateissuedenddate
      description: REST surface for published-dateIssuedStartDate-dateIssuedEndDate.
      operations:
      - method: GET
        name: getpackagesbydateissued1
        description: Retrieve list of packages based on dateIssued value range
        call: openapi-published.getpackagesbydateissued1
        with:
          dateIssuedStartDate: rest.dateIssuedStartDate
          dateIssuedEndDate: rest.dateIssuedEndDate
          offsetMark: rest.offsetMark
          offset: rest.offset
          pageSize: rest.pageSize
          collection: rest.collection
          congress: rest.congress
          docClass: rest.docClass
          billVersion: rest.billVersion
          modifiedSince: rest.modifiedSince
          courtCode: rest.courtCode
          courtType: rest.courtType
          state: rest.state
          topic: rest.topic
          natureSuitCode: rest.natureSuitCode
          natureSuit: rest.natureSuit
          isGLP: rest.isGLP
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: openapi-published-mcp
    port: 9090
    transport: http
    description: MCP adapter for GovInfo API — Published. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: retrieve-list-packages-based-dateissued
      description: Retrieve list of packages based on dateIssued value
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openapi-published.getpackagesbydateissued
      with:
        dateIssuedStartDate: tools.dateIssuedStartDate
        offsetMark: tools.offsetMark
        offset: tools.offset
        pageSize: tools.pageSize
        collection: tools.collection
        congress: tools.congress
        docClass: tools.docClass
        billVersion: tools.billVersion
        modifiedSince: tools.modifiedSince
        courtCode: tools.courtCode
        courtType: tools.courtType
        state: tools.state
        topic: tools.topic
        isGLP: tools.isGLP
        natureSuitCode: tools.natureSuitCode
        natureSuit: tools.natureSuit
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-list-packages-based-dateissued-2
      description: Retrieve list of packages based on dateIssued value range
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openapi-published.getpackagesbydateissued1
      with:
        dateIssuedStartDate: tools.dateIssuedStartDate
        dateIssuedEndDate: tools.dateIssuedEndDate
        offsetMark: tools.offsetMark
        offset: tools.offset
        pageSize: tools.pageSize
        collection: tools.collection
        congress: tools.congress
        docClass: tools.docClass
        billVersion: tools.billVersion
        modifiedSince: tools.modifiedSince
        courtCode: tools.courtCode
        courtType: tools.courtType
        state: tools.state
        topic: tools.topic
        natureSuitCode: tools.natureSuitCode
        natureSuit: tools.natureSuit
        isGLP: tools.isGLP
      outputParameters:
      - type: object
        mapping: $.