Oracle Marketplace API

openapi: 3.2.0
info:
  description: Use the Marketplace API to manage applications in Oracle Cloud Infrastructure Marketplace. For more information, see [Overview of Marketplace](/Content/Marketplace/Concepts/marketoverview.htm)
  title: Service Marketplace API
  version: '20181001'
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/5610b7055ecadc9a892072b09a4984658029c630ca7f33c8669ed31484d1da3d.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the Marketplace Service API OCI service and stored verbatim; API Evangelist added only this provenance block.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own index of every OCI service specification
  - url: https://docs.oracle.com/en-us/iaas/api/specs/5610b7055ecadc9a892072b09a4984658029c630ca7f33c8669ed31484d1da3d.yaml
    what: the harvested document for Marketplace Service API
servers:
- url: http://marketplace.us-ashburn-1.oci.oraclecloud.com/20181001
- url: https://marketplace.us-ashburn-1.oci.oraclecloud.com/20181001
tags:
- name: Marketplace
paths:
  /acceptedAgreements:
    get:
      description: 'Lists the terms of use agreements that have been accepted in the specified compartment.

        You can filter results by specifying query parameters.

        '
      operationId: ListAcceptedAgreements
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/DisplayNameQueryParam'
      - $ref: '#/components/parameters/ListingIdQueryParam'
      - $ref: '#/components/parameters/PackageVersionQueryParam'
      - $ref: '#/components/parameters/AcceptedAgreementIdQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/AcceptedAgreementsSortByQueryParam'
      - $ref: '#/components/parameters/AcceptedAgreementsSortOrderQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response,

                then a partial list might have been returned. Include this value as the `page` parameter for the

                subsequent GET request to get the next batch of items.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/AcceptedAgreementSummary'
                type: array
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets the list of accepted terms of use agreements in the specified compartment.
      tags:
      - Marketplace
      x-example: 'GET /20181001/acceptedAgreements?compartmentId=<var>&lt;compartmentId&gt;</var>

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
    post:
      description: 'Accepts a terms of use agreement for a specific package version of a listing. You must accept all

        terms of use for a package before you can deploy the package.

        '
      operationId: CreateAcceptedAgreement
      parameters:
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/OpcRetryTokenHeaderParam'
      responses:
        '200':
          description: The agreement is marked as accepted.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcceptedAgreement'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '412':
          $ref: '#/components/responses/412'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Accepts a terms of use agreement for a listing.
      tags:
      - Marketplace
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAcceptedAgreementDetails'
        description: Details necessary to accept an agreement.
        required: true
  /acceptedAgreements/{acceptedAgreementId}:
    delete:
      description: 'Removes a previously accepted terms of use agreement from the list of agreements that Marketplace checks

        before initiating a deployment. Listings in Marketplace that require acceptance of the specified terms

        of use can no longer be deployed, but existing deployments aren''t affected.

        '
      operationId: DeleteAcceptedAgreement
      parameters:
      - $ref: '#/components/parameters/AcceptedAgreementIdPathParam'
      - $ref: '#/components/parameters/SignatureQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/IfMatchHeaderParam'
      responses:
        '204':
          description: The specified terms of use agreement will be removed from the list of accepted terms of use.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '412':
          $ref: '#/components/responses/412'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Removes an accepted terms of use agreement.
      tags:
      - Marketplace
      x-related-resource: '#/definitions/AcceptedAgreement'
    get:
      description: 'Gets the details of a specific, previously accepted terms of use agreement.

        '
      operationId: GetAcceptedAgreement
      parameters:
      - $ref: '#/components/parameters/AcceptedAgreementIdPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcceptedAgreement'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets the details of a terms of use agreement.
      tags:
      - Marketplace
    put:
      description: 'Updates the display name or tags associated with a listing''s previously accepted terms of use agreement.

        '
      operationId: UpdateAcceptedAgreement
      parameters:
      - $ref: '#/components/parameters/AcceptedAgreementIdPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/OpcRetryTokenHeaderParam'
      - $ref: '#/components/parameters/IfMatchHeaderParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcceptedAgreement'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '412':
          $ref: '#/components/responses/412'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Updates an accepted terms of use agreement.
      tags:
      - Marketplace
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAcceptedAgreementDetails'
        description: Details to update for an accepted agreement.
        required: true
  /categories:
    get:
      description: 'Gets the list of all the categories for listings published to Oracle Cloud Infrastructure Marketplace. Categories apply

        to the software product provided by the listing.

        '
      operationId: ListCategories
      parameters:
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response,

                then a partial list might have been returned. Include this value as the `page` parameter for the

                subsequent GET request to get the next batch of items.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/CategorySummary'
                type: array
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets a list of listing categories.
      tags:
      - Marketplace
      x-example: 'GET /20181001/categories

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/CategorySummary'
  /listings:
    get:
      description: 'Gets a list of listings from Oracle Cloud Infrastructure Marketplace by searching keywords and

        filtering according to listing attributes.


        If you plan to launch an instance from an image listing, you must first subscribe to the listing. When

        you launch the instance, you also need to provide the image ID of the listing resource version that you want.


        Subscribing to the listing requires you to first get a signature from the terms of use agreement for the

        listing resource version. To get the signature, issue a [GetAppCatalogListingAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements/GetAppCatalogListingAgreements) API call.

        The [AppCatalogListingResourceVersionAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements) object, including

        its signature, is returned in the response. With the signature for the terms of use agreement for the desired

        listing resource version, create a subscription by issuing a

        [CreateAppCatalogSubscription](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogSubscription/CreateAppCatalogSubscription) API call.


        To get the image ID to launch an instance, issue a [GetAppCatalogListingResourceVersion](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersion/GetAppCatalogListingResourceVersion) API call.

        Lastly, to launch the instance, use the image ID of the listing resource version to issue a [LaunchInstance](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/Instance/LaunchInstance) API call.

        '
      operationId: ListListings
      parameters:
      - $ref: '#/components/parameters/ListingNameQueryParam'
      - $ref: '#/components/parameters/ListingIdQueryParam'
      - $ref: '#/components/parameters/ImageIdOptionalQueryParam'
      - $ref: '#/components/parameters/PublisherIdQueryParam'
      - $ref: '#/components/parameters/PackageTypeQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/ListingsSortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/CategoryQueryParam'
      - $ref: '#/components/parameters/PricingQueryParam'
      - $ref: '#/components/parameters/FeaturedQueryParam'
      - $ref: '#/components/parameters/ListingTypeOptionalQueryParam'
      - $ref: '#/components/parameters/OperatingSystemQueryParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response,

                then a partial list might have been returned. Include this value as the `page` parameter for the

                subsequent GET request to get the next batch of items.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ListingSummary'
                type: array
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets a list of listings.
      tags:
      - Marketplace
      x-example: 'GET /20181001/listings

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
  /listings/{listingId}:
    get:
      description: 'Gets detailed information about a listing, including the listing''s name, version, description, and

        resources.


        If you plan to launch an instance from an image listing, you must first subscribe to the listing. When

        you launch the instance, you also need to provide the image ID of the listing resource version that you want.


        Subscribing to the listing requires you to first get a signature from the terms of use agreement for the

        listing resource version. To get the signature, issue a [GetAppCatalogListingAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements/GetAppCatalogListingAgreements) API call.

        The [AppCatalogListingResourceVersionAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements) object, including

        its signature, is returned in the response. With the signature for the terms of use agreement for the desired

        listing resource version, create a subscription by issuing a

        [CreateAppCatalogSubscription](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogSubscription/CreateAppCatalogSubscription) API call.


        To get the image ID to launch an instance, issue a [GetAppCatalogListingResourceVersion](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersion/GetAppCatalogListingResourceVersion) API call.

        Lastly, to launch the instance, use the image ID of the listing resource version to issue a [LaunchInstance](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/Instance/LaunchInstance) API call.

        '
      operationId: GetListing
      parameters:
      - $ref: '#/components/parameters/ListingIdPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Listing'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets the details of a listing.
      tags:
      - Marketplace
      x-example: 'GET /20181001/listings/<var>&lt;listingId&gt;</var>

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
  /listings/{listingId}/packages:
    get:
      description: 'Gets the list of packages for a listing.


        If you plan to launch an instance from an image listing, you must first subscribe to the listing. When

        you launch the instance, you also need to provide the image ID of the listing resource version that you want.


        Subscribing to the listing requires you to first get a signature from the terms of use agreement for the

        listing resource version. To get the signature, issue a [GetAppCatalogListingAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements/GetAppCatalogListingAgreements) API call.

        The [AppCatalogListingResourceVersionAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements) object, including

        its signature, is returned in the response. With the signature for the terms of use agreement for the desired

        listing resource version, create a subscription by issuing a

        [CreateAppCatalogSubscription](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogSubscription/CreateAppCatalogSubscription) API call.


        To get the image ID to launch an instance, issue a [GetAppCatalogListingResourceVersion](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersion/GetAppCatalogListingResourceVersion) API call.

        Lastly, to launch the instance, use the image ID of the listing resource version to issue a [LaunchInstance](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/Instance/LaunchInstance) API call.

        '
      operationId: ListPackages
      parameters:
      - $ref: '#/components/parameters/ListingIdPathParam'
      - $ref: '#/components/parameters/PackageVersionQueryParam'
      - $ref: '#/components/parameters/PackageTypeQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/ListingsSortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response,

                then a partial list might have been returned. Include this value as the `page` parameter for the

                subsequent GET request to get the next batch of items.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ListingPackageSummary'
                type: array
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets the list of packages for a listing.
      tags:
      - Marketplace
      x-example: 'GET /20181001/listings/<var>&lt;listingId&gt;</var>/packages

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/ListingPackageSummary'
  /listings/{listingId}/packages/{packageVersion}:
    get:
      description: 'Get the details of the specified version of a package, including information needed to launch the package.


        If you plan to launch an instance from an image listing, you must first subscribe to the listing. When

        you launch the instance, you also need to provide the image ID of the listing resource version that you want.


        Subscribing to the listing requires you to first get a signature from the terms of use agreement for the

        listing resource version. To get the signature, issue a [GetAppCatalogListingAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements/GetAppCatalogListingAgreements) API call.

        The [AppCatalogListingResourceVersionAgreements](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersionAgreements) object, including

        its signature, is returned in the response. With the signature for the terms of use agreement for the desired

        listing resource version, create a subscription by issuing a

        [CreateAppCatalogSubscription](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogSubscription/CreateAppCatalogSubscription) API call.


        To get the image ID to launch an instance, issue a [GetAppCatalogListingResourceVersion](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/AppCatalogListingResourceVersion/GetAppCatalogListingResourceVersion) API call.

        Lastly, to launch the instance, use the image ID of the listing resource version to issue a [LaunchInstance](https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/Instance/LaunchInstance) API call.

        '
      operationId: GetPackage
      parameters:
      - $ref: '#/components/parameters/ListingIdPathParam'
      - $ref: '#/components/parameters/PackageVersionPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingPackage'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Get the details of a specific package version.
      tags:
      - Marketplace
      x-example: 'GET /20181001/listings/<var>&lt;listingId&gt;</var>/packages/<var>&lt;packageVersion&gt;</var>

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/ListingPackage'
  /listings/{listingId}/packages/{packageVersion}/agreements:
    get:
      description: 'Returns the terms of use agreements that must be accepted before you can deploy the specified version of a package.

        '
      operationId: ListAgreements
      parameters:
      - $ref: '#/components/parameters/ListingIdPathParam'
      - $ref: '#/components/parameters/PackageVersionPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response,

                then a partial list might have been returned. Include this value as the `page` parameter for the

                subsequent GET request to get the next batch of items.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/AgreementSummary'
                type: array
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Lists terms of use agreements for a package.
      tags:
      - Marketplace
      x-example: 'GET /20181001/listings/<var>&lt;listingId&gt;</var>/packages/<var>&lt;packageVersion&gt;</var>/agreements

        Host: marketplace.us-ashburn-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
  /listings/{listingId}/packages/{packageVersion}/agreements/{agreementId}:
    get:
      description: 'Returns a terms of use agreement for a package with a time-based signature that can be used to

        accept the agreement.

        '
      operationId: GetAgreement
      parameters:
      - $ref: '#/components/parameters/ListingIdPathParam'
      - $ref: '#/components/parameters/PackageVersionPathParam'
      - $ref: '#/components/parameters/AgreementIdPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        '200':
          description: The operation succeeded.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agreement'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Gets a terms of use agreement for a package.
      tags:
      - Marketp

# --- truncated at 32 KB (160 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle/refs/heads/main/openapi/oracle-marketplace-api-openapi.yml