Skip to content

Latest commit

 

History

History

README.md

REST API

The Marketplace Platform REST API allows you to interact with the platform programmatically.

The APIs are organized around REST principles, use predictable resource-oriented URLs, JSON-encoded representations, and standard HTTP methods and status codes.

Each API works similarly, whether you access it directly over HTTP or through helper libraries in various programming languages.

Common use cases

Use Marketplace APIs to:

  • Manage accounts, users, and groups.
  • Automate order processing and fulfillment workflows.
  • Manage orders, subscriptions, and assets.
  • Retrieve billing and financial data.
  • Synchronize Marketplace data with external business systems.
  • Integrate and manage notification workflows.

Authentication

Marketplace Platform uses API tokens for authentication.

Include your API token in the Authorization HTTP header with the Bearer scheme.

Your API keys have permissions assigned to them, so keep them secure. Don't share your secret API keys in public areas, like GitHub or client-side code.

HTTPS requirements

All API requests must be made over HTTPS.

Requests sent over HTTP are not supported. API requests without authentication will fail.

Content-type requirements

Most Marketplace API endpoints expect requests to use the application/json content type. Endpoints that support file uploads may require multipart/form-data instead.

GET https://api.platform.softwareone.com/public/v1/accounts/buyers
Authorization: Bearer {TOKEN_VALUE}
Content-Type: application/json

To communicate successfully with the APIs, ensure your API requests are formatted using the application/json content type.

Using the wrong content type may result in unexpected behavior or errors.

Browse APIs

APIDescription
Accounts APIManage accounts, users, groups, & more. accounts-api
Audit APITrack and retrieve audit activity.audit-api
Billing APIWork with invoices, statements, charges, & more.billing-api
Catalog APIManage catalog, products, items, & more.catalog-api
Commerce APIManage orders, subscriptions, assets, & more.commerce-api
Currency APIWork with currencies, pairs, and exchange rates.currency-api
Extensions APIManage extensions, installations, media, & more.extensions-api
Helpdesk APIManage cases, chats, feedback, & more.helpdesk-api
Notifications APIManage notifications, subscribers, & more.notifications-api
Product Catalog APIBrowse software products, manage profile, categories, & more.product-catalog-api
Program APIManage programs, enrollments, and certificates.program-api
Spotlight APIWork with spotlight objects and queries.spotlight-objects-api
Task APICreate tasks and retrieve task logs and results.task-api