You can access and use the API endpoint URI ( with any of the following tools:

  • The Swagger user interface
  • The cURL HTTP client
  • An HTTP client in any programming language

Swagger user interface

The Swagger UI is useful for initial introduction and for learning about API operations, models and simulated usage.

Authenticating to Swagger

To authenticate to the Swagger UI:

  1. Open the Swagger UI page in a browser.


  2. Click Authorize.

    The Available Authorizations box is shown with the headers and values that are used for authentication in all API interactions with Swagger.


  3. Insert the API Key values:

    1. Enter the Account Key as the x-api-key value and click Authorize.
    2. Enter the Secret Key as the x-api-secret-key value and click Authorize.
    3. Click Close.
Note -
The key values are not saved when you refresh the page.

When authorization is successful the lock icon appears as a closed lock.


Making API requests

After you complete the authorization in the Swagger UI, you can make an API request:

  1. Open an action category and select an API operation.

    For example, in the Account category select the GET /payment-methods operation.


  2. Click Try it out and Execute.

    The API response is shown in the Responses section of the API operation. The results include an example of how you to execute the same operation in a standard command-line utility using cURL.


Inputs for operations in Swagger

Some API operations require input, such as:

  • Parameters - When an API operation requires URI parameters, such as “get subscription by subscription id”, you can enter the values for the parameters.


  • JSON Request Body - For API operations that require a JSON request body, you can either:

    • Use the model display to write the request based on the expected JSON structure and parameters.


    • Use the Try it now sample JSON created by Swagger as a base template that you can edit and execute.


Warning -
The Swagger UI generates default JSON examples for POST and PUT operations. You can reference these examples and modify them to fit your specific needs and account settings. The examples will fail if used as-is. Use the how to articles for more examples of Cloud API operations.

Using the cURL HTTP client

cURL is a popular command line tool used to perform HTTP requests, either as individual commands or within shell scripts (mostly Linux Bash). For an introduction to cURL, see How to start using cURL and why: a hands-on introduction.

We use cURL and Linux shell scripts to provide examples on using the API.

For example, a standard API call to get System Log information looks like this in cURL:

curl -s -X GET "https://$HOST/logs" \
    -H "accept: application/json" \
    -H "x-api-key: $ACCOUNT_KEY" \
    -H "x-api-secret-key: $SECRET_KEY" \
    | jq -r .
  • The example expects several variables to be set in the Linux shell:

  • The line “| jq -r .” means that the HTTP response will be piped (forwarded) to the jq JSON command-line processor, and it will display only the raw output (“-r”) of the root element (“.”)

  • You can set the variables using shell commands like the following:

export ACCOUNT_KEY={replace-with-your-account-key}
export SECRET_KEY={replace-with-your-secret-key}