API Documentation
Authentication
Users
Entities
- GETList entities
- GETAPI to get entities by type
- Get entities id
- GETList entity addresses
- GETList entity taxes
- GETAPI to get entities by type with filters
- POSTAPI to create an entity
- POSTCreate entities
- Post entities id addresses
- POSTCreate entity taxes
- PUTUpdate entity
- PUTUpdate entity address
- PUTUpdate entity tax
- DELAPI to delete an entity
- Delete entities id addresses addressid
- DELDelete entity tax
Catalog
Billing
Contracts
- GETGet contracts
- Get contracts contractid milestones
- GETList contract plans
- GETGet id
- Post contracts contractid milestones
- POSTAdd plan to contract
- Post contracts contractid plans contractplanid invoices
- POSTCreate milestones
- POSTAdd taxes to contract
- Post contracts import
- Post contracts import bulk
- PUTUpdate contract plan
- PUTChange contract plan
- PUTUpdate contract tax
- PUTUpdate contract
- DELDelete contractPlanId
- DELDelete contractPlanItemMilestoneId
- DELRemove contract tax
Invoices
- GETGet invoices
- Get invoices id payments
- GETAPI to get invoice details by ID
- GETList invoice templates
- POSTCreate invoices
- POSTAPI to create a batch of invoices
- Post invoices id payments
- Post invoices invoiceid document
- POSTAPI to create invoice item
- POSTAPI to update invoice status and dates
- POSTSync invoice revenue
- POSTAPI to sync an invoice with usage data
- POSTCreate invoice template
- Put invoices id payments paymentid
- PUTUpdate invoice
- PUTAPI to update invoice item
- PUTUpdate invoice template
- Delete invoices id payments paymentid
- DELDelete payment file
- DELDelete invoice file
- DELDelete invoice template
Payments
Metering
Events
Jobs
State Machine
Workflows
FX Rates
Collections
Apps
Webhooks
Attributes
Email templates
FSM (object lifecycle)
- GETAPI to get state machines
- GETAPI to get all actions for a model
- GETAPI to get all states for a model
- POSTAPI to create a state machine
- POSTAPI to get all available actions for multiple model instances
- POSTAPI to undo the last transition on a model
- POSTAPI to enqueue a bulk transition job on multiple model instances
Masters
Organisation attributes
Organisation settings
Change contract plan
curl --request PUT \
--url https://api.getenso.ai/contracts/{contractId}/plans/{contractPlanId}/change \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"startDate": "2026-05-01",
"endDate": "2027-04-30",
"PlanId": "200"
}
'{
"status": "success",
"message": "Success",
"data": {}
}Contracts
Change contract plan
Switch a contract to a new plan effective from a given date (mid-term plan change). Requires startDate and endDate.
PUT
/
contracts
/
{contractId}
/
plans
/
{contractPlanId}
/
change
Change contract plan
curl --request PUT \
--url https://api.getenso.ai/contracts/{contractId}/plans/{contractPlanId}/change \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"startDate": "2026-05-01",
"endDate": "2027-04-30",
"PlanId": "200"
}
'{
"status": "success",
"message": "Success",
"data": {}
}Not accessible by SystemUser role. Requires Admin.
Authorizations
JWT bearer token obtained from POST /auth/system-login using your client credentials.
Path Parameters
Contract ID
Contract Plan ID
Body
application/json
⌘I