Use cURL

The examples within this document use cURL to demonstrate how to access the REST API for the Consumer Service in Oracle API Platform Cloud Service.

To use cURL to access the REST API for the Consumer Service in Oracle API Platform Cloud Service:

  • Install cURL, as described in Quick Start.

  • In a command window, set the cURL environment variable, CURL_CA_BUNDLE, to the location of your local CA certificate bundle. For information about CA certificate verification using cURL, see:

  • Invoke cURL and specify one or more of the command-line options defined in the following table, as required, to direct its execution

    cURL Option Description
    -d, --data @file.json

    Identifies the request document, in JSON format, on the local machine.


    Defines one or both of the following:

    • Content type of the request document

    • Custom headers


    Displays response header information.

    -H "Authorization: Bearer

    Specifies the user name and password for the Oracle API Platform Cloud Service account.


    Indicates the type of request (for example, GET, POST, and so on).

For example:

curl -i -X GET 
-H "Authorization: Bearer access_token"
-H "Content-Type: application/json"
-d @api.json


In releases prior to 18.2.5, the REST endpoints were protected using Basic Authorization instead of OAuth. If you are using an earlier version, you must specify an Authorization header whose value contains the base 64-encrypted user name and password (separated by a colon) of an Oracle API Platform Cloud Service user with authorization to perform the requested operation. This header looks like:

Authorization: Basic base64-encrypted-username:base64-encrypted-password