CampusAPI Budgeting Services API documentation version 0.1.5
Based on OSID version 3.0.0
https://base.url/budgeting
Overview
The Financials Budgeting package manages budgets.
This package includes the following entities:
Budgets
A Budget relates a Financial Activity to a FiscalPeriod and is composed of BudgetEntries.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this budget, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this budget, provided by system. | string(uri) |
displayName | The name of this budget for display. | string |
description | The description of this budget. | string |
genusTypeId (read‑only) | Id of the immutable type of this budget. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this budget. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
startDate | The starting date of this budget. | string(date‑time) |
endDate | The ending date of this budget. | string(date‑time) |
endReasonId | The reason this budget ended. References a process.State object. | string(osid‑id) |
activityId (read‑only) | The activity associated with this budget. References a financials.Activity object. | string(osid‑id) |
fiscalPeriodId (read‑only) | The fiscal period associated with this budget. References a financials.FiscalPeriod object. | string(osid‑id) |
BudgetEntries
A BudgetEntry is relationship relating a Budget to a general ledger Account. The BudgetEntry includes the amount budgeted.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this budget entry, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this budget entry, provided by system. | string(uri) |
displayName | The name of this budget entry for display. | string |
description | The description of this budget entry. | string |
genusTypeId (read‑only) | Id of the immutable type of this budget entry. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this budget entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
startDate | The starting date of this budget entry. | string(date‑time) |
endDate | The ending date of this budget entry. | string(date‑time) |
endReasonId | The reason this budget entry ended. References a process.State object. | string(osid‑id) |
budgetId (read‑only) | The budget associated with this budget entry. References a budgeting.Budget object. | string(osid‑id) |
accountId (read‑only) | The account associated with this budget entry. References a financials.Account object. | string(osid‑id) |
amount | The amount of this budget entries. | string(currency) |
debit | Tests if the budgeted amount is to be debited or a credited to this activity. | boolean |
Businesses
Accounts, Activities, and FiscalPeriods are organized into federaable Businesses.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this business, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this business, provided by system. | string(uri) |
displayName | The name of this business for display. | string |
description | The description of this business. | string |
genusTypeId (read‑only) | Id of the immutable type of this business. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this business. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
providerId | The provider of this business. References a resource.Resource object. | string(osid‑id) |
brandingIds | The branding of this business. References repository.Asset objects. | string(osid‑id)[] |
license | The licensing that applies to this business. | string |
License
CampusAPI REST Documentation Copyright 2023 DXtera Institute. Based on the Open Service Interface Definitions: http://osid.org
/budgets
Collection of Budgets in a system, federation of systems, or in a default Business.
Get all Budgets in the system or default Business.
Create a new Budget in the default Business.
get /budgets
Get all Budgets in the system or default Business.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "activity", "fiscalPeriod", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleBudgetType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleBudgetType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleBudgetType%40campusapi.org
- fromDate: (string)
Get all budgets from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all budgets up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- activityId: (string)
the id string to match a activity.
Example:
financials.Activity%3A480%40base.url
- fiscalPeriodId: (string)
the id string to match a fiscal-period.
Example:
financials.FiscalPeriod%3A780%40base.url
- businessId: (string)
The id string to match a business
Example:
financials.Business%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "budgeting.Budget:3526@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budget/budgeting.Budget%3A3526%40base.url",
"displayName": "Display Name of this Budget",
"description": "The description of this Budget",
"genusTypeId": "type.Type:defaultBudgetType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:3526@base.url",
"activityId": "financials.Activity:8896@base.url",
"fiscalPeriodId": "financials.FiscalPeriod:7683@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /budgets
Create a new Budget in the default Business.
Query Parameters
- activityId: required(string)
the activity of this budget.
Example:
financials.Activity%3A480%40base.url
- fiscalPeriodId: required(string)
the fiscal-period of this budget.
Example:
financials.FiscalPeriod%3A780%40base.url
- genusType: (string)
specify a particular budget type to create
Example:
type.Type%3AexampleBudgetType%40dxtera.org
- recordType: (array of )
specify support for one or more budget record types
Example:
[ "type.Type%3AexampleBudgetRecordType%40campusapi.org", "..." ]
- businessId: (string)
specify in which business to create this budget
Example:
budgeting.Business%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Budget",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this budget, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget for display.",
"type": "string"
},
"description": {
"description": "The description of this budget.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this budget. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this budget.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this budget ended.",
"type": "string",
"format": "osid-id"
},
"activityId": {
"description": "The activity associated with this budget.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"fiscalPeriodId": {
"description": "The fiscal period associated with this budget.",
"type": "string",
"format": "osid-id",
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Budget",
"description": "The description of this Budget",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8874@base.url"
}
Query the collection of Budgets in a system, federation of systems, or in a default business by posting a Query object.
Submit a query using a BudgetQuery object.
post /budgets/budget-query
Submit a query using a BudgetQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "activity", "fiscalPeriod", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BudgetQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchEffective": {
"description": "Match effective objects where the current date falls within the start and end dates inclusive. true to match any effective, false to match ineffective",
"type": "boolean"
},
"matchStartDate": {
"description": "Matches temporals whose start date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndDate": {
"description": "Matches temporals whose end date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndReasonIds": {
"description": "List of end reason Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"endReasonQueries": {
"description": "process.StateQueries to match end reason state. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyEndReason": {
"description": "Match end reasons with any value. true to match Budgets with any end reason, false to match Budgets with no end reason",
"type": "boolean"
},
"matchActivityIds": {
"description": "List of activity Ids for this query to match budget that have a related activity.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"activityQueries": {
"description": "ActivityQueries to match the activity. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchFiscalPeriodIds": {
"description": "List of fiscalPeriod Ids for this query to match budget that have a related fiscalPeriod.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"fiscalPeriodQueries": {
"description": "FiscalPeriodQueries to match the fiscalPeriod. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchBusinessIds": {
"description": "List of Business Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"businessId": {
"description": "Business id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"businessQueries": {
"description": "BusinessQueries to match Business. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "budgeting.Budget:3526@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budget/budgeting.Budget%3A3526%40base.url",
"displayName": "Display Name of this Budget",
"description": "The description of this Budget",
"genusTypeId": "type.Type:defaultBudgetType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:3526@base.url",
"activityId": "financials.Activity:8896@base.url",
"fiscalPeriodId": "financials.FiscalPeriod:7683@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Budget form metadata.
Get form metadata for creating a new Budget.
get /budgets/metadata
Get form metadata for creating a new Budget.
Query Parameters
- activityId: required(string)
the activity of this metadatum.
Example:
financials.Activity%3A480%40base.url
- fiscalPeriodId: required(string)
the fiscal-period of this metadatum.
Example:
financials.FiscalPeriod%3A780%40base.url
- genusType: (string)
specify a particular budget type to create
Example:
type.Type%3AexampleBudgetType%40dxtera.org
- recordType: (array of )
specify support for one or more budget record types
Example:
[ "type.Type%3AexampleBudgetRecordType%40campusapi.org", "..." ]
- businessId: (string)
specify in which business to create this budget
Example:
budgeting.Business%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Budget",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this budget, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this budget",
"linked": false
},
"description": {
"description": "The description of this budget.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this budget",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this budget. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this budget",
"linked": false
},
"endDate": {
"description": "The ending date of this budget.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this budget",
"linked": false
},
"endReasonId": {
"description": "The reason this budget ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this budget ended",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Budget
Get a particular Budget given its id.
Update a particular Budget given its id.
Delete a particular Budget given its id.
get /budgets/{budgetId}
Get a particular Budget given its id.
URI Parameters
- budgetId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "activity", "fiscalPeriod", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "budgeting.Budget:3526@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budget/budgeting.Budget%3A3526%40base.url",
"displayName": "Display Name of this Budget",
"description": "The description of this Budget",
"genusTypeId": "type.Type:defaultBudgetType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:3526@base.url",
"activityId": "financials.Activity:8896@base.url",
"fiscalPeriodId": "financials.FiscalPeriod:7683@base.url"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Budget not found" }
put /budgets/{budgetId}
Update a particular Budget given its id.
URI Parameters
- budgetId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Budget",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this budget, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget for display.",
"type": "string"
},
"description": {
"description": "The description of this budget.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this budget. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this budget.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this budget ended.",
"type": "string",
"format": "osid-id"
},
"activityId": {
"description": "The activity associated with this budget.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"fiscalPeriodId": {
"description": "The fiscal period associated with this budget.",
"type": "string",
"format": "osid-id",
"readOnly": true
}
}
}
Example:
{
"displayName": "Display Name of this Budget",
"description": "The description of this Budget",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:8874@base.url"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Budget has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Budget not found" }
delete /budgets/{budgetId}
Delete a particular Budget given its id.
URI Parameters
- budgetId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Budget has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Budget not found" }
Entity representing a Budget form metadata for update
Get form metadata for updating an existing Budget.
get /budgets/{budgetId}/metadata
Get form metadata for updating an existing Budget.
URI Parameters
- budgetId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Budget",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this budget, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this budget",
"linked": false
},
"description": {
"description": "The description of this budget.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this budget",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this budget. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this budget",
"linked": false
},
"endDate": {
"description": "The ending date of this budget.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this budget",
"linked": false
},
"endReasonId": {
"description": "The reason this budget ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Budget.Budget:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this budget ended",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "budget not found" }
/budget-entries
Collection of BudgetEntries in a system, federation of systems, or in a default Business.
Get all BudgetEntries in the system or default Business.
Create a new BudgetEntry in the default Business.
get /budget-entries
Get all BudgetEntries in the system or default Business.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "budget", "account", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleBudgetEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleBudgetEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleBudgetEntryType%40campusapi.org
- fromDate: (string)
Get all budget-entries from this date inclusive. Use with toDate to define date range query.
Example:
2020-10-03
- toDate: (string)
Get all budget-entries up to this date inclusive. Use with fromDate to define date range query.
Example:
2020-12-18
- budgetId: (string)
the id string to match a budget.
Example:
budgeting.Budget%3A594%40base.url
- accountId: (string)
the id string to match a account.
Example:
financials.Account%3A770%40base.url
- businessId: (string)
The id string to match a business
Example:
financials.Business%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "budgeting.BudgetEntry:1334@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budgetEntry/budgeting.BudgetEntry%3A1334%40base.url",
"displayName": "Display Name of this BudgetEntry",
"description": "The description of this BudgetEntry",
"genusTypeId": "type.Type:defaultBudgetEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:1334@base.url",
"budgetId": "financials.budgeting.Budget:4601@base.url",
"accountId": "financials.Account:1465@base.url",
"amount": "USD+42.00",
"debit": true
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /budget-entries
Create a new BudgetEntry in the default Business.
Query Parameters
- budgetId: required(string)
the budget of this budget-entry.
Example:
budgeting.Budget%3A594%40base.url
- accountId: required(string)
the account of this budget-entry.
Example:
financials.Account%3A770%40base.url
- genusType: (string)
specify a particular budgetEntry type to create
Example:
type.Type%3AexampleBudgetEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more budgetEntry record types
Example:
[ "type.Type%3AexampleBudgetEntryRecordType%40campusapi.org", "..." ]
- businessId: (string)
specify in which business to create this budgetEntry
Example:
budgeting.Business%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BudgetEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this budget entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget entry for display.",
"type": "string"
},
"description": {
"description": "The description of this budget entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this budget entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this budget entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this budget entry ended.",
"type": "string",
"format": "osid-id"
},
"budgetId": {
"description": "The budget associated with this budget entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"accountId": {
"description": "The account associated with this budget entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"amount": {
"description": "The amount of this budget entries.",
"type": "string",
"format": "currency"
},
"debit": {
"description": "Tests if the budgeted amount is to be debited or a credited to this activity.",
"type": "boolean"
}
}
}
Example:
{
"displayName": "Display Name of this BudgetEntry",
"description": "The description of this BudgetEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5553@base.url",
"amount": "USD+42.00",
"debit": true
}
Query the collection of BudgetEntries in a system, federation of systems, or in a default business by posting a Query object.
Submit a query using a BudgetEntryQuery object.
post /budget-entries/budget-entry-query
Submit a query using a BudgetEntryQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "budget", "account", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BudgetEntryQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchEffective": {
"description": "Match effective objects where the current date falls within the start and end dates inclusive. true to match any effective, false to match ineffective",
"type": "boolean"
},
"matchStartDate": {
"description": "Matches temporals whose start date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndDate": {
"description": "Matches temporals whose end date falls in between the given dates inclusive.",
"type": "object",
"properties": {
"start": {
"description": "start of date range",
"type": "string",
"format": "date-time"
},
"end": {
"description": "end of date range",
"type": "string",
"format": "date-time"
},
"match": {
"description": "true if a positive match, false for negative match",
"type": "boolean"
}
}
},
"matchEndReasonIds": {
"description": "List of end reason Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"endReasonQueries": {
"description": "process.StateQueries to match end reason state. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyEndReason": {
"description": "Match end reasons with any value. true to match BudgetEntries with any end reason, false to match BudgetEntries with no end reason",
"type": "boolean"
},
"matchBudgetIds": {
"description": "List of budget Ids for this query to match budget entry that have a related budget.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"budgetQueries": {
"description": "BudgetQueries to match the budget. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAccountIds": {
"description": "List of account Ids for this query to match budget entry that have a related account.",
"type": "array",
"items": {
"type": "object",
"properties": {
"ruleId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"accountQueries": {
"description": "AccountQueries to match the account. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAmount": {
"description": "Matches amounts in the given range inclusive.",
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"description": "a starting range",
"type": "string",
"format": "currency"
},
"to": {
"description": "an ending range",
"type": "string",
"format": "currency"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchAnyAmount": {
"description": "Match amounts with any value. true to match BudgetEntries with any amount, false to match ProgramOfferings with no amount",
"type": "boolean"
},
"matchDebit": {
"description": "Match boolean value for debit.",
"type": "object",
"properties": {
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
},
"matchBusinessIds": {
"description": "List of Business Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"businessId": {
"description": "Business id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"businessQueries": {
"description": "BusinessQueries to match Business. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "budgeting.BudgetEntry:1334@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budgetEntry/budgeting.BudgetEntry%3A1334%40base.url",
"displayName": "Display Name of this BudgetEntry",
"description": "The description of this BudgetEntry",
"genusTypeId": "type.Type:defaultBudgetEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:1334@base.url",
"budgetId": "financials.budgeting.Budget:4601@base.url",
"accountId": "financials.Account:1465@base.url",
"amount": "USD+42.00",
"debit": true
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a BudgetEntry form metadata.
Get form metadata for creating a new BudgetEntry.
get /budget-entries/metadata
Get form metadata for creating a new BudgetEntry.
Query Parameters
- budgetId: required(string)
the budget of this metadatum.
Example:
budgeting.Budget%3A594%40base.url
- accountId: required(string)
the account of this metadatum.
Example:
financials.Account%3A770%40base.url
- genusType: (string)
specify a particular budgetEntry type to create
Example:
type.Type%3AexampleBudgetEntryType%40dxtera.org
- recordType: (array of )
specify support for one or more budgetEntry record types
Example:
[ "type.Type%3AexampleBudgetEntryRecordType%40campusapi.org", "..." ]
- businessId: (string)
specify in which business to create this budgetEntry
Example:
budgeting.Business%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "BudgetEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this budget entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this budget entry",
"linked": false
},
"description": {
"description": "The description of this budget entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this budget entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this budget entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this budget entry",
"linked": false
},
"endDate": {
"description": "The ending date of this budget entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this budget entry",
"linked": false
},
"endReasonId": {
"description": "The reason this budget entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this budget entry ended",
"linked": false
},
"amount": {
"description": "The amount of this budget entries.",
"type": "string",
"format": "currency",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "financials.budgeting.BudgetEntry:amount@dxtera.org",
"existingValue": "USD+120.56",
"elementLabel": "Amount",
"instructions": "Enter the amount of this budget entry.",
"linked": false
},
"debit": {
"description": "Tests if the budgeted amount is to be debited or a credited to this activity.",
"type": "boolean",
"elementId": "financials.budgeting.BudgetEntry:debit@dxtera.org",
"existingValue": false,
"elementLabel": "Debit",
"instructions": "Enter true or false.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a BudgetEntry
Get a particular BudgetEntry given its id.
Update a particular BudgetEntry given its id.
Delete a particular BudgetEntry given its id.
get /budget-entries/{budgetEntryId}
Get a particular BudgetEntry given its id.
URI Parameters
- budgetEntryId: required(string)
Query Parameters
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "budget", "account", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "budgeting.BudgetEntry:1334@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budgetEntry/budgeting.BudgetEntry%3A1334%40base.url",
"displayName": "Display Name of this BudgetEntry",
"description": "The description of this BudgetEntry",
"genusTypeId": "type.Type:defaultBudgetEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:1334@base.url",
"budgetId": "financials.budgeting.Budget:4601@base.url",
"accountId": "financials.Account:1465@base.url",
"amount": "USD+42.00",
"debit": true
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "BudgetEntry not found" }
put /budget-entries/{budgetEntryId}
Update a particular BudgetEntry given its id.
URI Parameters
- budgetEntryId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BudgetEntry",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this budget entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget entry for display.",
"type": "string"
},
"description": {
"description": "The description of this budget entry.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this budget entry. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget entry.",
"type": "string",
"format": "date-time"
},
"endDate": {
"description": "The ending date of this budget entry.",
"type": "string",
"format": "date-time"
},
"endReasonId": {
"description": "The reason this budget entry ended.",
"type": "string",
"format": "osid-id"
},
"budgetId": {
"description": "The budget associated with this budget entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"accountId": {
"description": "The account associated with this budget entry.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"amount": {
"description": "The amount of this budget entries.",
"type": "string",
"format": "currency"
},
"debit": {
"description": "Tests if the budgeted amount is to be debited or a credited to this activity.",
"type": "boolean"
}
}
}
Example:
{
"displayName": "Display Name of this BudgetEntry",
"description": "The description of this BudgetEntry",
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:5553@base.url",
"amount": "USD+42.00",
"debit": true
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The BudgetEntry has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "BudgetEntry not found" }
delete /budget-entries/{budgetEntryId}
Delete a particular BudgetEntry given its id.
URI Parameters
- budgetEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The BudgetEntry has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "BudgetEntry not found" }
Entity representing a BudgetEntry form metadata for update
Get form metadata for updating an existing BudgetEntry.
get /budget-entries/{budgetEntryId}/metadata
Get form metadata for updating an existing BudgetEntry.
URI Parameters
- budgetEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "BudgetEntry",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this budget entry, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this budget entry, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this budget entry for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this budget entry",
"linked": false
},
"description": {
"description": "The description of this budget entry.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this budget entry",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this budget entry. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this budget entry. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"startDate": {
"description": "The starting date of this budget entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:startDate@base.url",
"existingValue": "2020-10-03T08:00:00.000Z",
"elementLabel": "Start Date",
"instructions": "Enter a starting date for this budget entry",
"linked": false
},
"endDate": {
"description": "The ending date of this budget entry.",
"type": "string",
"format": "date-time",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:endDate@base.url",
"existingValue": "2020-12-18T17:00:00.000Z",
"elementLabel": "End Date",
"instructions": "Enter an ending date for this budget entry",
"linked": false
},
"endReasonId": {
"description": "The reason this budget entry ended. A process/State object.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "BudgetEntry.BudgetEntry:endReason@base.url",
"existingValue": "process.State:1860@base.url",
"elementLabel": "End Reason",
"instructions": "Select the reason this budget entry ended",
"linked": false
},
"amount": {
"description": "The amount of this budget entries.",
"type": "string",
"format": "currency",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "financials.budgeting.BudgetEntry:amount@dxtera.org",
"existingValue": "USD+120.56",
"elementLabel": "Amount",
"instructions": "Enter the amount of this budget entry.",
"linked": false
},
"debit": {
"description": "Tests if the budgeted amount is to be debited or a credited to this activity.",
"type": "boolean",
"elementId": "financials.budgeting.BudgetEntry:debit@dxtera.org",
"existingValue": false,
"elementLabel": "Debit",
"instructions": "Enter true or false.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "budgetEntry not found" }
/businesses
Collection of Businesses in a system or federation of systems.
Get all Businesses.
Create a new Business.
get /businesses
Get all Businesses.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "provider", "branding", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleBusinessType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleBusinessType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleBusinessType%40campusapi.org
- providerId: (string)
Id string to match provider.
Example:
resource.Resource%3A3007%40demo.dxtera.org
- budgetId: (string)
Get businesses mapped to this budget.
Example:
budgeting.Budget%3A432%40demo.dxtera.org
- budgetEntryId: (string)
Get businesses mapped to this budget-entry.
Example:
budgeting.BudgetEntry%3A864%40demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "financials.Business:2663@base.url",
"uri": "http://base.url/open/campusapi/financials/business/financials.Business%3A2663%40base.url",
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"genusTypeId": "type.Type:defaultBusinessType@base.url",
"recordTypeIds": [ "type.Type:exampleBusinessRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /businesses
Create a new Business.
Query Parameters
- genusType: (string)
specify a particular business type to create
Example:
type.Type%3AexampleBusinessType%40dxtera.org
- recordType: (array of )
specify support for one or more business record types
Example:
[ "type.Type%3AexampleBusinessRecordType%40campusapi.org", "..." ]
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Business",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this business, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this business, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this business for display.",
"type": "string"
},
"description": {
"description": "The description of this business.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this business. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this business. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this business.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this business. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this business.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
}
Query the collection of Businesses in a system, federation of systems, or in a default business by posting a Query object.
Submit a query using a BusinessQuery object.
post /businesses/business-query
Submit a query using a BusinessQuery object.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: , or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "BusinessQuery",
"type": "object",
"properties": {
"matchIds": {
"description": "List of Ids to match. Boolean OR performed among multiple Ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchKeywords": {
"description": "List keywords to match. Multiple keywords can be added to perform a boolean OR among them. A keyword may be applied to any of the elements defined in this object such as the display name, description or any attribute defined in or implemented by this object.",
"type": "array",
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "keyword to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDisplayNames": {
"description": "List of displayName strings to match. Boolean OR performed among multiple displayNames.",
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"description": "displayName to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchDescriptions": {
"description": "List of discription strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"description": "description to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchGenusTypeIds": {
"description": "List of genus type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "genus type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchRecordTypeIds": {
"description": "List of record type ids to match. Boolean OR performed among multiple ids.",
"type": "array",
"items": {
"type": "object",
"properties": {
"genusTypeid": {
"description": "record type id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchProviderIds": {
"description": "List of provider Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"providerQueries": {
"description": "resource.ResourceQuery for provider. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
},
"matchAnyProvider": {
"description": "Match providers with any value. true to match Business with any provider, false to match Business with no provider",
"type": "boolean"
}
},
"matchBrandingIds": {
"description": "List of branding asset Ids to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"stateId": {
"description": "id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"brandingQueries": {
"description": "repository.AssetQuery for branding. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
},
"matchAnyBranding": {
"description": "Match brandingss with any value. true to match Business with any branding, false to match Business with no branding",
"type": "boolean"
},
"matchlicenses": {
"description": "List of license strings to match. Boolean OR performed among multiple descriptions.",
"type": "array",
"items": {
"type": "object",
"properties": {
"license": {
"description": "license to match",
"type": "string"
},
"stringMatchType": {
"description": "the string match type",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"matchBusinessIds": {
"description": "List of Business Id's to match.",
"type": "array",
"items": {
"type": "object",
"properties": {
"businessId": {
"description": "Business id to match",
"type": "string",
"format": "osid-id"
},
"match": {
"description": "true for a positive match, false for a negative match",
"type": "boolean"
}
}
}
},
"businessQueries": {
"description": "BusinessQueries to match Business. Each query performs a boolean OR.",
"type": "array",
"items": {
"type": "object"
}
}
}
}
Example:
{
"matchDisplayNames": [
{
"displayName": "string to exclude",
"match": false
}
]
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "financials.Business:2663@base.url",
"uri": "http://base.url/open/campusapi/financials/business/financials.Business%3A2663%40base.url",
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"genusTypeId": "type.Type:defaultBusinessType@base.url",
"recordTypeIds": [ "type.Type:exampleBusinessRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Business form metadata.
Get form metadata for creating a new Business.
get /businesses/metadata
Get form metadata for creating a new Business.
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Business",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this business, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this business, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this business for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this business",
"linked": false
},
"description": {
"description": "The description of this business.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this business",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this business. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this business. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this business.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this business",
"linked": false
},
"brandingIds": {
"description": "The branding of this business. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "Business.Business:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this business",
"linked": false
},
"license": {
"description": "The licensing that applies to this business.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this business",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
The root Businesses in the Business hierarchy. A node with no parents is an orphan. While all Business Ids are known to the hierarchy, an orphan does not appear in the hierarchy unless explicitly added as a root node or child of another node.
Get all root root-business
get /businesses/root-business
Get all root root-business
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "financials.Business:2663@base.url",
"uri": "http://base.url/open/campusapi/financials/business/financials.Business%3A2663%40base.url",
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"genusTypeId": "type.Type:defaultBusinessType@base.url",
"recordTypeIds": [ "type.Type:exampleBusinessRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a Business
Get a particular Business given its id.
Update a particular Business given its id.
Delete a particular Business given its id.
get /businesses/{businessId}
Get a particular Business given its id.
URI Parameters
- businessId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "financials.Business:2663@base.url",
"uri": "http://base.url/open/campusapi/financials/business/financials.Business%3A2663%40base.url",
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"genusTypeId": "type.Type:defaultBusinessType@base.url",
"recordTypeIds": [ "type.Type:exampleBusinessRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Business not found" }
put /businesses/{businessId}
Update a particular Business given its id.
URI Parameters
- businessId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Business",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this business, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this business, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this business for display.",
"type": "string"
},
"description": {
"description": "The description of this business.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this business. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this business. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this business.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this business. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this business.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Business has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Business not found" }
delete /businesses/{businessId}
Delete a particular Business given its id.
URI Parameters
- businessId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The Business has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "Business not found" }
Entity representing a Business form metadata for update
Get form metadata for updating an existing Business.
get /businesses/{businessId}/metadata
Get form metadata for updating an existing Business.
URI Parameters
- businessId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Business",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this business, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this business, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this business for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this business",
"linked": false
},
"description": {
"description": "The description of this business.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this business",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this business. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this business. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this business.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this business",
"linked": false
},
"brandingIds": {
"description": "The branding of this business. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "Business.Business:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this business",
"linked": false
},
"license": {
"description": "The licensing that applies to this business.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Business.Business:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this business",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "business not found" }
Get child Businesses for the given Business in the hierarchy.
get /businesses/{businessId}/children
Get child Businesses for the given Business in the hierarchy.
URI Parameters
- businessId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "financials.Business:2663@base.url",
"uri": "http://base.url/open/campusapi/financials/business/financials.Business%3A2663%40base.url",
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"genusTypeId": "type.Type:defaultBusinessType@base.url",
"recordTypeIds": [ "type.Type:exampleBusinessRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add Business as child of the given Business in the hierarchy.
Remove the given Business as a child of the given Business in the hierarchy.
put /businesses/{businessId}/children/{childId}
Add Business as child of the given Business in the hierarchy.
URI Parameters
- businessId: required(string)
- childId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The child Business has been added to the hierarchy" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "business not found" }
delete /businesses/{businessId}/children/{childId}
Remove the given Business as a child of the given Business in the hierarchy.
URI Parameters
- businessId: required(string)
- childId: required(string)
Get parent Businesses for the given Business in the hierarchy.
get /businesses/{businessId}/parents
Get parent Businesses for the given Business in the hierarchy.
URI Parameters
- businessId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "financials.Business:2663@base.url",
"uri": "http://base.url/open/campusapi/financials/business/financials.Business%3A2663%40base.url",
"displayName": "Display Name of this Business",
"description": "The description of this Business",
"genusTypeId": "type.Type:defaultBusinessType@base.url",
"recordTypeIds": [ "type.Type:exampleBusinessRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Business@base.url",
"license": "The license that applies to this Business"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Get all Budgets in this Business
get /businesses/{businessId}/budgets
Get all Budgets in this Business
URI Parameters
- businessId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "activity", "fiscalPeriod", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleBudgetType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleBudgetType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleBudgetType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "budgeting.Budget:3526@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budget/budgeting.Budget%3A3526%40base.url",
"displayName": "Display Name of this Budget",
"description": "The description of this Budget",
"genusTypeId": "type.Type:defaultBudgetType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:3526@base.url",
"activityId": "financials.Activity:8896@base.url",
"fiscalPeriodId": "financials.FiscalPeriod:7683@base.url"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given Budget to this Business
Remove the given Budget from the Business.
put /businesses/{businessId}/budgets/{budgetId}
Add the given Budget to this Business
URI Parameters
- businessId: required(string)
- budgetId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "Budget has been added to Business" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "Budget not found" }
delete /businesses/{businessId}/budgets/{budgetId}
Remove the given Budget from the Business.
URI Parameters
- businessId: required(string)
- budgetId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "Budget has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "Budget not found" }
Get all BudgetEntries in this Business
get /businesses/{businessId}/budget-entries
Get all BudgetEntries in this Business
URI Parameters
- businessId: required(string)
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- expand: (string)
Expand object or type for named attribute: "genusType", "recordType", "endReason", "budget", "account", or "all" to expand all referenced objects or types. This parameter can be repeated to expand multiples.
Example:
all
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleBudgetEntryType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleBudgetEntryType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleBudgetEntryType%40campusapi.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "budgeting.BudgetEntry:1334@base.url",
"uri": "http://base.url/open/campusapi/budgeting/budgetEntry/budgeting.BudgetEntry%3A1334%40base.url",
"displayName": "Display Name of this BudgetEntry",
"description": "The description of this BudgetEntry",
"genusTypeId": "type.Type:defaultBudgetEntryType@base.url",
"recordTypeIds": [ "type.Type:exampleBudgetEntryRecordType@campusapi.org", "..."],
"startDate": "2020-10-03T06:30:00.000Z",
"endDate": "2020-12-18T19:30:00.000Z",
"endReasonId": "process.State:1334@base.url",
"budgetId": "financials.budgeting.Budget:4601@base.url",
"accountId": "financials.Account:1465@base.url",
"amount": "USD+42.00",
"debit": true
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given BudgetEntry to this Business
Remove the given BudgetEntry from the Business.
put /businesses/{businessId}/budget-entries/{budgetEntryId}
Add the given BudgetEntry to this Business
URI Parameters
- businessId: required(string)
- budgetEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "BudgetEntry has been added to Business" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "BudgetEntry not found" }
delete /businesses/{businessId}/budget-entries/{budgetEntryId}
Remove the given BudgetEntry from the Business.
URI Parameters
- businessId: required(string)
- budgetEntryId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "BudgetEntry has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "BudgetEntry not found" }