Skip to content

Elevate Customer and Sites API (1.49)

Customer and Site Management

Provides read & write access to customer and site entities.

Definitions

  • Customer - the primary entity within Elevate to represent the person or company who is contracted with a Contract Owner for the provision of products or services
  • Site - within each Customer, there are one or more Sites to represent the physical locations of the Customer

Products and services are associated to the Sites as inventory items. Sites can be setup to receive invoices individually or to consolidate invoices to a particular site or sites

Download OpenAPI description
billing-rest-customer.json
billing-rest-customer.yaml
Languages
Servers
https://rest.elevatebilling.com/v1

customers

Customers represent the person or company contracted to receive products or services

Operations

sites

Sites represent the physical locations for each Customer

Operations

customer-billing-summaries

Billing summary information for customers

Operations

customer-usage-data

Usage data records for customers

Operations

customer-usage-charge-group-category-summaries

Usage quantities and cost grouped by charge group category

Operations

customer-usage-by-charging-unit-type-summaries

Usage quantities and cost grouped by charging unit (DURATION/MB/ONE_OFF)

Operations

Check if customer usage by charging unit type information exists

Request

Count usage quantities grouped by charging unit type

Security
bearerAuth
Query
customerIdstring(IdFilterParam)required

Required filter by customer

Example: customerId=0
billRunIdstring(IdFilterParam)

Optional filter by bill run

Example: billRunId=0
chargingUnitTypestring(StringFilterParam)

Optional filter by charge unit type

Example: chargingUnitType=xyz | in:x,y | like:xyz
curl -i -X HEAD \
  'https://rest.elevatebilling.com/v1/customer-usage-by-charging-unit-type-summaries?customerId=0&billRunId=0&chargingUnitType=xyz+%7C+in%3Ax%2Cy+%7C+like%3Axyz' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Exists

Headers
X-Total-Countinteger

Total number of summary records

Body

Returns customer usage by charging unit type summary information

Request

Returns usage quantities grouped by charging unit type

Security
bearerAuth
Query
pageinteger(int32)(PageParam)>= 1required

Page of results to show

Example: page=1
pageSizeinteger(int32)(ResultsPerPageParam)[ 1 .. 1000 ]required

Results to return per page

Example: pageSize=100
sortstring(SortParam)

Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change

Example: sort=id,name | name:desc
fieldsstring(FieldsParam)

Comma-delimited list of the field(s) to return if only a subset is required

Example: fields=id,name
customerIdstring(IdFilterParam)required

Required filter by customer

Example: customerId=0
billRunIdstring(IdFilterParam)

Optional filter by bill run

Example: billRunId=0
chargingUnitTypestring(StringFilterParam)

Optional filter by charge unit type

Example: chargingUnitType=xyz | in:x,y | like:xyz
curl -i -X GET \
  'https://rest.elevatebilling.com/v1/customer-usage-by-charging-unit-type-summaries?page=1&pageSize=100&sort=id%2Cname+%7C+name%3Adesc&fields=id%2Cname&customerId=0&billRunId=0&chargingUnitType=xyz+%7C+in%3Ax%2Cy+%7C+like%3Axyz' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/jsonArray [
customerIdinteger(int64)read-only

Customer identifier

Example: 1
billRunIdinteger(int64)

Bill run identifier

Example: 0
billRunNamestring[ 1 .. 22 ] characters[a-zA-Z0-9\p{L}\s\+\/\-\._\&amp;#=,:@()]*read-only

Bill run name

chargingUnitSummariesArray of objects(CustomerUsageByChargingUnitTypeValue)non-empty
]
Response
application/json
[
  {
    "customerId": 1,
    "billRunId": 0,
    "billRunName": "string",
    "chargingUnitSummaries": [ … ]
  }
]

customer-usage-site-summaries

Usage quantities and cost grouped by site

Operations