Skip to main content
Version: Current

Account Manager API

Overview​

Manage an Implementation Partner’s profile, IntelliAppZ, customers, subscriptions, licenses, and hosted models. An Implementation Partner account is required.

Service origin​

https://accounts.onintellibuddies.com

Use the hosted origin shown above. Endpoint paths include /api; append them directly to the origin, without adding another /api.

Get started​

  1. Obtain an account with access to the resources you need. See partner registration.
  2. Call Get Access Token with your credentials.
  3. Copy the returned access_token value into the Bearer header below.
  4. Run the request with your own account. The command uses cURL in a POSIX shell.
curl --request GET \
--url 'https://accounts.onintellibuddies.com/api/integration/partner/info' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ACCESS_TOKEN'

A successful request returns 200 OK and your partner profile. See Get Partner Profile Info for an example response.

Authentication​

Protected operations use Bearer access tokens. Login uses account credentials, and Refresh Access Token exchanges a refresh token for new tokens. The login example returns an access-token lifetime of 1800 seconds. Use the latest returned refresh token; verify rotation and expiration rules with the service owner.

Endpoints​

OperationMethod and pathPurpose
Get Access TokenPOST /api/integration/partner/loginObtain an access token by signing in with your account credentials.
Get IntelliAppZ Customer Info by Subscription IDGET /api/integration/partner/appzcustomer/bysubscriptionRetrieve customer information for an IntelliAppZ subscription associated with the authenticated Implementation Partner.
Get IntelliAppZ Customer InfoGET /api/integration/partner/appzcustomer/byidRetrieve an IntelliAppZ customer associated with the authenticated Implementation Partner using its customer ID.
List IntelliAppZ by IDGET /api/integration/partner/appz/byIdRetrieve IntelliAppZ configurations for an AppZ GUID. Optionally filter by unit type or version.
List IntelliAppZ CustomersGET /api/integration/partner/appzcustomer/allList IntelliAppZ customers associated with the authenticated Implementation Partner.
List IntelliAppZGET /api/integration/partner/appz/allList IntelliAppZ associated with the authenticated Implementation Partner.
List Licenses by Subscription IDGET /api/integration/partner/licenses/bysubscriptionRetrieve licenses for a subscription associated with the authenticated Implementation Partner.
List SubscriptionsGET /api/integration/partner/subscription/allList subscriptions associated with the authenticated Implementation Partner. Optionally filter by customer ID.
List Partner Hosted ModelsGET /api/integration/partner/models/allList hosted models for the authenticated Implementation Partner. Optionally filter by service provider.
Get Partner Profile InfoGET /api/integration/partner/infoRetrieve the authenticated Implementation Partner’s profile, contact details, and account status.
Refresh Access TokenPOST /api/integration/partner/refreshtokenExchange a refresh token for a new access token and refresh token.
Get Subscription Summary by IDGET /api/integration/partner/subscription/summaryRetrieve a subscription summary, including customer and purchase details, for the authenticated Implementation Partner.

Next steps​

Use IDs returned by the list operations to retrieve customer, subscription, and license details. A subscription number is different from its numeric database ID.

See Usage and troubleshooting for response conventions, retry considerations, and current reference limitations.