How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Decisiv Service Provider API

Base API allowing dealers and service providers to interact with their customers and those customers' assets, including group customers and group assets. Swagger 2.0, secured with OAuth 2.0 plus the transition token.

This API exposes 11 operations across 7 paths, organized into 4 resource areas, and defines 30 schemas. It is described by OpenAPI 2.0, at version 2.0.4.

Requests are made against the base URL https://service-provider.decisivapps.com/api/v1/.

11 operations 7 paths 30 schemas 2 DELETE6 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2.0.4
Base URL
https://service-provider.decisivapps.com/api/v1/
Authentication
API Key, OAuth 2.0, API Key
Terms of Service
Resource Areas
4

Authentication & Security 3

Decisiv Service Provider API declares 3 security schemes for authenticating requests. An API key is passed in the header as X-Decisiv-Transition-Token (TransitionToken). It supports OAuth 2.0 (OAuth2Password) using the password flow. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • TransitionToken — The transition token must be specified when using OAuth. Please see https://api-docs.decisiv.net/docs/api/oauth/
  • OAuth2Password — Oauth flow with Transition Token. See https://api-docs.decisiv.net/docs/api/oauth/

Paths & Operations 11

Across 7 paths, the API surfaces 11 operations — 2 DELETE, 6 GET, 2 POST, 1 PUT. They span 4 resource areas: customers, group_customers, assets, group_assets. Each is listed below with its method, path, parameters, and response codes.

customers 4
GET
/customers
Returns all Customers in the system for the authenticated Service Location
getCustomers 7 params → 200default429
POST
/customers
Creates a new Customer for use within the ecosystem
addCustomer 1 param → 201400429
GET
/customers/{id}
Returns a Customer based on the provided ID
findCustomerById 1 param → 200404429
PUT
/customers/{id}
Updates a Customer record
updateCustomer 2 params → 200404429
group_customers 1
GET
/group_customers
Returns all Group Customers in the system for the authenticated Service Location
getGroupCustomers 1 param → 200default400429
assets 4
GET
/assets
Returns a listing of assets for all a Dealers' Customers
assets 4 params → 200429
POST
/assets
Assigns an asset to a customer based upon the id
AssignAssetToCustomer 1 param → 201412422429
GET
/assets/{asset_id}
Returns a Customer Asset record based upon a particular ID
GetCustomerAssetById 1 param → 200404429
DELETE
/assets/{asset_id}
Removes a Customer Asset from a Customers' inventory based upon ID
RemoveCustomerAssetById 1 param → 204404429
group_assets 2
GET
/group_assets
Returns a listing of group assets for all a Dealers' Customers
groupAssets 1 param → 200400429
DELETE
/group_assets/{asset_id}
Removes a Group Customer Asset from a Customer's inventory based upon ID
RemoveGroupCustomerAssetById 1 param → 204404429

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are jsonapiCustomerResponse (16 properties), jsonapiCustomersResponse (16 properties), jsonapiCustomerUpdateObject (13 properties), jsonapiCustomerObject (12 properties). Each schema is shown below with its type and property counts.

assetCustomerId
object
2 properties
customer
object
12 properties 1 required
jsonapiCustomerResponse
object
16 properties
jsonapiCustomersResponse
object
16 properties
jsonapiCustomerObject
object
12 properties 1 required
jsonapiCustomerUpdateObject
object
13 properties
jsonapiAssetCustomerObject
object
1 property 1 required
customerAsset
object
5 properties
jsonapiCustomerAssetResponse
object
1 property
jsonapiCustomerAssetsResponse
object
2 properties
audit_details
object
4 properties
badRequestDmsIdFilterMissingErrorWithExample
object
Error objects provide additional information about problems encountered while performing an operation. Error objects MUST be returned as an array keyed by erro…
5 properties
badRequestDmsIdFilterMissingResponseError
array
Request is not sent as expected
badRequestDmsIdFilterMissingResponse
object
1 property
badRequestVINFilterMissingErrorWithExample
object
Error objects provide additional information about problems encountered while performing an operation. Error objects MUST be returned as an array keyed by erro…
5 properties
badRequestVINFilterMissingResponseError
array
Request is not sent as expected
badRequestVINFilterMissingResponse
object
1 property
tooManyRequestsResponseErrorWithExample
object
Error objects provide additional information about problems encountered while performing an operation. Error objects MUST be returned as an array keyed by erro…
4 properties
tooManyRequestsResponseError
array
Access restricted for a given user or application due to undesired behavior
tooManyRequestsResponse
object
1 property
jsonapiErrorResponse
object
1 property
JSONAPI_DocumentLink
string
A "JSON API" document link.
JSONAPI_Included
array
An array of resource objects that are related to the primary data and/or each other (“included resources”).
JSONAPI_jsonapi
object
An object describing the server's implementation.
1 property
JSONAPI_Errors
array
A server MAY choose to stop processing as soon as a problem is encountered, or it MAY continue processing and encounter multiple problems. When a server encoun…
JSONAPI_Error
object
Error objects provide additional information about problems encountered while performing an operation. Error objects MUST be returned as an array keyed by erro…
8 properties
JSONAPI_Links
object
Where specific, a links member can be used to represent links. The value of each "links" member MUST be a links object.
2 properties
JSONAPI_meta
object
A meta object that contains non-standard meta-information.
2 properties
PreconditionFailedError
object
5 properties 5 required
UnprocessableEntityErrorFleetOwned
object
5 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

decisiv-service-provider-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Decisiv Service Provider API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.