v1

latestOpenAPI 3.0.02026-07-263403911.5 MB
ServiceProduct

View service product

Find a single service product by ID.

get/v1/ServiceProduct/{id}

Path parameters

idinteger required

Format - int32. ID of the service product to view.

Response

OK

okboolean
service_product_idinteger

Primary identifier for this service product.

customer_idinteger

ID of associated customer account.

product_idinteger required

ID of source product from catalog.

package_idinteger

ID of the package of which this product is a member.

service_idinteger required

ID of the associated service.

descriptionstring

Contains the description of the product that will display on the bill.

code_1string

Supports provisioning codes for electronic ordering and provisioning with providers (i.e. USOC). This will be different for all electronic provisioning integrations.

code_2string

Used for ordering and provisioning with providers (i.e. FID). This will be different for all electronic provisioning integrations.

ratenumber double

Rate that will be passed on to the customer. Please use only positive numbers. Use the credit_flag field to pass a credit product.

billed_through_datestring date-time

The last day a customer was billed for this product.

canceled_datestring date-time

The effective day of cancellation.

status'PENDING' | 'ACTIVE' | 'DENIED' | 'DISCONNECTED'

The current status of the service product.

status_datestring date-time

The date this service product entered its current status.

status_user_idinteger

ID of the user responsible for the product's current status.

activated_datestring date-time

Date this product became active or billable.

costnumber double

Your company's cost for this service product. Used in relation to Rate to calculate margin.

wholesale_descriptionstring

A secondary description of the product, typically related to provider-side naming. Not visible to end users through typical means, but may be exposed via reporting at your discretion.

free_start_datestring date-time

Notes the start of a time frame for which this product is free.

free_end_datestring date-time

Notes the end of a time frame for which this product is free.

quantityinteger

Number of this type of product provided to end user. This is multiplied by the Rate field when calculating a recurring charge.

contract_start_datestring date-time

Beginning date for a contract to provide this service product.

contract_end_datestring date-time

Ending date for a contract to provide this service product.

automatic_expiration_end_datestring date-time

Ending date for the automatic expiration for this service product.

created_datestring date-time

The date this service product was added to the system.

tax_includedboolean

Indicates total amount of charge should not exceed the value in rate. The base amount is adjusted dynamically on charges produced each month, to ensure base + tax = rate.

group_on_billboolean

Applicable only to products that are a part of a package. Indicates this product's rate should be grouped into a sum package amount when displayed on a bill.

itemizedboolean

Applicable only to products that are a part of a package and grouped. Indicates that, although their price is grouped, the name of the product will still show indented underneath on the bill, but with no individual price displayed.

credit_flagboolean

Determines the type of service product.