basePath: / host: apis.accela.com info: description: The Assets and Assessments APIs enable apps to manage assets and their related condition assessments. title: Assets and Assessments version: v4 schemes: - https swagger: '2.0' tags: - name: Assets description: 'Assets can be any object that an agency owns or maintains. Assets have standard properties such as date of service, start value, current value, depreciation value, salvage value, size, etc. To manage and organize assets and asset types, Civic Platform supports several levels of asset classifications. Each asset is classified with an asset type, and each asset type can be organized within a group or by class type. In general, assets are classified by the following standard class types:
- **Linear** - The linear class type indicates a relationship between two assets. For example, a section of street, sidewalk, or runway at the city municipal airport.
- **Node** - Node-link linear combines assets to indicate an explicit relationship between the assets. Node-link linear requires the user to define the asset ID by identifying the assets on each end of the linear asset. For example, define a sewer main by identifying its end points such as Manholes. Manhole ''MH-01'' flows to manhole ''MH-02'' which flows to manhole ''MH-03.'' The node-link linear allows for the creation of the Sewer Main asset by naming the beginning and end point assets of each pipe. In this example, the agency can create two Sewer Main assets such as class type of node-link linear defined as ''MH-01 - MH-02'' and ''MH-02 - MH-03.''
- **Component** - The component class specifies assets that are independent and do not connect assets as a building or tools. A component is free of lines and nodes.
- **Polygon** - The polygon class type includes assets such as water drainage area, a storm drainage area, or a catch basin.' - name: Assets/Assessments description: Condition assessments apply to assets that change or deteriorate over time. These assets may require a visual condition assessment to effectively manage their life cycle. Transaction records and documents can also be attached to assets. In Civic Platform, an asset is created based on its asset type. An asset type can be associated to specific work order types ("record types"), rating types, and usage types. - name: Assets/Attributes description: In addition to these asset properties, assets can also have custom attributes which are customized characteristics of assets, structures, and establishments. Asset custom attributes can be grouped into a template, which can be used to create an asset. In addition to custom attributes, asset attribute data can be collected into an attribute table. - name: Assets/Documents description: Document collaterals can be attached to assets. - name: Assets/Records description: Assets can be associated to transactional records when an asset assessment necessitates a service work order or if an application pertains to an agency asset. - name: Assessments description: 'In Civic Platform, an assessment is synonymous to an asset condition assessment. An asset condition assessment is a scheduled maintenance review and/or a quality review of a group of assets. Agencies may require such assessments for many different asset types such as vehicles, buildings, and water lines. Agencies may set different intervals for different asset types as well. For example, agency vehicles might require safety and emissions inspections yearly, while water lines might require an assessment every three months. In Civic Platform, an assessment is created based on its assessment type. An assessment type defines the assessment''s custom attributes, rating types, and observation attributes.' - name: Assessments/Attributes description: An agency can define custom attributes for each type of assessment. - name: Assessments/Documents description: Inspectors can attach documents and photos as needed to the asset condition assessment record, and record the assignments and costs that occur on the assessment. - name: Assessments/Observations description: 'During an assessment, an inspector may make observations about the condition of the asset. For example, he may go to a certain area to look at the condition of the sidewalk and determine if there any cracks or whether the sidewalk is level. The inspector also looks at the area around the section sidewalk to determine whether trees or brushes block the walking path. After the inspector completes the assessment, the inspector can log his findings assessment observation, which he can modify later as more information becomes available. ' - name: Assessments/Work Orders description: Asset assessments often alert agencies to problems that need attention. A work order is the starting point in the repair process. Associating a work order with an assessment helps track the work order's progress. paths: /v4/assets: get: description: "Returns all assets. Specify at least one URI filter parameter: asssetId, group, type, name.\n\n\n\n**API\ \ Endpoint**: GET /v4/assets \n\n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access\ \ token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Get All Assets operationId: v4.get.assets tags: - Assets parameters: - $ref: '#/parameters/authHeaderParam' - description: 'Filter by asset ID. ' in: query name: assetId type: string - description: Filter by asset name. in: query name: name type: string - description: Filter by asset group. See [Get All Asset Groups](./api-settings.html#operation/v4.get.settings.assets.groups). in: query name: group type: string - description: Filter by asset type. See [Get All Asset Types](./api-settings.html#operation/v4.get.settings.assettypes.types). in: query name: type type: string - $ref: '#/parameters/offset' - $ref: '#/parameters/limit' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetMasterModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{ids}: get: description: "Returns asset information for one or more given assets, identified in comma-separated {ids}. Associated\ \ records can be requested via the expand parameter.\n\n\n\n**API Endpoint**: GET /v4/assets/{ids} \n\n**Scope**:\ \ assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**: 9.0.0\n\ \n" summary: Get Assets operationId: v4.get.assets.ids tags: - Assets parameters: - $ref: '#/parameters/authHeaderParam' - description: Comma-delimited IDs of assets to fetch. in: path name: ids required: true type: string - description: Comma-delimited list of related objects to be returned with the response. The related object(s) will be returned if data exists; if data does not exist, the requested object(s) will not be included in the response. in: query name: expand enum: - records type: string - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetExtModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. delete: description: "Deletes one or more assets.\n\n\n\n**API Endpoint**: DELETE /v4/assets/{ids} \n\n**Scope**: assets \n\ \n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Delete Assets operationId: v4.delete.assets.ids tags: - Assets parameters: - $ref: '#/parameters/authHeaderParam' - description: Comma-delimited IDs of assets to delete. in: path name: ids required: true type: string - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{id}: put: description: "Updates a given asset.\n\n\n\n**API Endpoint**: PUT /v4/assets/{id} \n\n**Scope**: assets \n\n**App\ \ Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Update Asset operationId: v4.put.assets.id tags: - Assets parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssetPathParam' - description: The asset information to be updated. in: body name: body required: true schema: $ref: '#/definitions/assetWithAttributesModel' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{id}/linkedAssets: get: description: "Returns all linked assets for a given asset ID.\n\n\n\n**API Endpoint**: GET /v4/assets/{id}/linkedAssets\ \ \n\n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get All Linked Assets operationId: v4.get.assets.id.linkedAssets tags: - Assets parameters: - $ref: '#/parameters/authHeaderParam' - description: The ID of the asset whose linked assets need to be fetched. in: path name: id required: true type: string - description: Comma-delimited list of related objects to be returned with the response. The related object(s) will be returned if data exists; if data does not exist, the requested object(s) will not be included in the response. in: query name: expand enum: - records type: string - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetRelatedModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{id}/usages: post: description: "Create Asset Usages.\n\n\n\n**API Endpoint**: POST /v4/assets/{id}/usages \n\n**Scope**: assets \n\n\ **App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**: 22.1.0\n\n" summary: Create Asset Usages operationId: v4.post.assets.id.usages tags: - Assets parameters: - $ref: '#/parameters/authHeaderParam' - description: The ID of the asset. in: path name: id required: true type: string - description: The asset information to be created. in: body name: body required: true schema: $ref: '#/definitions/request_assetUsageModel' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetUsageModel' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{id}/assessments: post: description: "Creates condition assessments for a given asset.\n\n\n\n**API Endpoint**: POST /v4/assets/{id}/assessments\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Create Asset Assessment operationId: v4.post.assets.id.assessments tags: - Assets/Assessments parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssetPathParam' - description: 'Asset attributes to be added. Ex. [{ "field1": "field1Val", "field2": "field2Val"}]' in: body name: attributes required: true schema: $ref: '#/definitions/request_assessmentModel' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{id}/attributes: get: description: "Returns the custom attribute values for a given asset. The custom attributes are configured in an attribute\ \ template which is assigned to the asset type in Civic Platform Administration.\n\n\n\n**API Endpoint**: GET /v4/assets/{id}/attributes\ \ \n\n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get Asset Custom Attributes operationId: '' tags: - Assets/Attributes parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssetPathParam' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_customAttributeModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. put: description: "Updates the custom attributes for a given asset. The response returns an array containing any custom attribute\ \ validation error and the status of the asset update.\n\n\n\n**API Endpoint**: PUT /v4/assets/{id}/attributes \n\ \n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**:\ \ 9.0.0\n\n" summary: Update Asset Custom Attributes operationId: v4.put.assets.id.attributes tags: - Assets/Attributes parameters: - $ref: '#/parameters/authHeaderParam' - description: The ID of the asset to be updated. in: path name: id required: true type: string - description: 'The custom attributes to be updated. Ex. [{ "field1": "field1Val", "field2": "field2Val"}]' in: body name: body required: true schema: $ref: '#/definitions/customAttributeModel' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{id}/attributes/meta: get: description: "Returns an array containing the metadata of the asset custom attributes. The metadata is configured in\ \ an attributes template which is assigned to the asset type in Civic Platform Administration.\n\n\n\n**API Endpoint**:\ \ GET /v4/assets/{id}/attributes/meta \n\n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**:\ \ Access token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Get Metadata of Asset Custom Attributes operationId: v4.get.assets.id.attributes.meta tags: - Assets/Attributes parameters: - $ref: '#/parameters/authHeaderParam' - description: The ID of the asset to fetch. in: path name: id required: true type: string - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_attributeMetadataModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{assetId}/documents: get: description: "Returns all documents for a given asset.\n\n\n\n**API Endpoint**: GET /v4/assets/{assetId}/documents\ \ \n\n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get All Asset Documents operationId: v4.get.assets.assetId.documents tags: - Assets/Documents parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assetIdPathParam' - $ref: '#/parameters/limit' - $ref: '#/parameters/offset' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_documentModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. post: description: "Creates one or more document attachments for the given asset. To specify the documents to be attached,\ \ use the HTTP header \"Content-Type:multipart/form-data\" and form-data for \"uploadedFile\" and \"fileInfo\". Note\ \ that the \"fileInfo\" is a string containing an array of file attributes. Use \"fileInfo\" to specify one or more\ \ documents to be attached. For example:\n\n\tContent - Disposition: form - data;name = \"uploadedFile\"; filename=\"\ summaryReport.pdf\"\n\n\tContent - Disposition: form - data;name = \"fileInfo\"\n\n\t[\n\t\t {\n\t\t\t\"serviceProviderCode\"\ : \"BPTDEV\",\n\t\t\t\"fileName\": \"CXA12-pipe.png\",\n\t\t\t\"type\": \"image/png\",\n\t\t\t\"description\": \"\ Inspected pipe\"\n\t\t}\n\t]\n\n\n\n \n\n\n\n**API Endpoint**: POST /v4/assets/{assetId}/documents \n\n**Scope**:\ \ assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**: 9.0.0\n\ \n" summary: Create Asset Documents operationId: v4.post.assets.assetId.documents tags: - Assets/Documents consumes: - multipart/form-data parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assetIdPathParam' - description: Specify the filename parameter with the file to be uploaded. See example for details. in: formData name: uploadedFile required: true type: file - description: A string array containing the file metadata for each specified filename. See example for details. in: formData name: fileInfo type: string required: true - description: The document group. in: query name: group type: string - description: The document category. in: query name: category type: string - description: The EDMS Adapter User ID. It's required for user level authentication in: query name: userId type: string - description: The EMDS Adapter password. It's required for user level authentication in: query name: password type: string - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{assetId}/documents/{documentIds}: delete: description: "Deletes one or more documents for the given asset.\n\n\n\n**API Endpoint**: DELETE /v4/assets/{assetId}/documents/{documentIds}\ \ \n\n**Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Delete Asset Documents operationId: v4.delete.assets.assetId.documents.documentIds tags: - Assets/Documents parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assetIdPathParam' - description: Comma-delimited IDs of documents to be deleted. in: path name: documentIds required: true type: string - description: The standard EDMS Adapter userid. It's required for user level authentication in: query name: userId type: string - description: The standard EDMS Adapter password. It's required for user level authentication in: query name: password type: string - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/records?assetIds={assetIds}: get: summary: Get Records By Asset Ids description: "Gets the list of records associated with the given asset ID(s). \n\n\n\n**API Endpoint**: GET /v4/assets/records?assetIds={assetIds}\ \ \n\n**Scope**: records \n\n**App Type**: All \n\n**Authorization Type**: Access token \n\n**Civic Platform version**:\ \ \t22.1.0\n\n" operationId: v4.get.assets.records tags: - Assets/Records parameters: - $ref: '#/parameters/authHeaderParam' - description: The IDs of the assets. in: path name: assetIds required: true type: string - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' - $ref: '#/parameters/limit' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetsRecordsModel' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assets/{assetId}/records: get: description: "Returns all records for a given asset.\n\n\n\n**API Endpoint**: GET /v4/assets/{assetId}/records \n\n\ **Scope**: assets \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**:\ \ 9.0.0\n\n" summary: Get All Asset Records operationId: v4.get.assets.assetId.records tags: - Assets/Records parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assetIdPathParam' - $ref: '#/parameters/offset' - $ref: '#/parameters/limit' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_simpleRecordModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/mine: get: description: "Returns the condition assessments assigned to the currently logged-in agency user.\n\n\n\n**API Endpoint**:\ \ GET /v4/assessments/mine \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access\ \ token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Get My Condition Assessments operationId: v4.get.assessments.mine tags: - Assessments parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/offset' - $ref: '#/parameters/limit' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetConditionAssessmentModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{id}: get: description: "Gets condition assessment information for one or more given assessments, identified in comma-separated\ \ {ids}.\n\n\n\n**API Endpoint**: GET /v4/assessments/{id} \n\n**Scope**: assessments \n\n**App Type**: Agency\ \ \n\n**Authorization Type**: Access token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Get Assessments operationId: v4.get.assessments.id tags: - Assessments parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssessmentPathParam' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_assetConditionAssessmentModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. put: description: "Updates a given condition assessment.\n\n\n\n**API Endpoint**: PUT /v4/assessments/{id} \n\n**Scope**:\ \ assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**:\ \ 9.0.0\n\n" summary: Update Assessment operationId: v4.put.assessments.id tags: - Assessments parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssessmentPathParam' - description: The assessment information to be updated. in: body name: body required: true schema: $ref: '#/definitions/request_assessmentModel' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{ids}: delete: description: "Deletes one or more condition assessments.\n\n\n\n**API Endpoint**: DELETE /v4/assessments/{ids} \n\n\ **Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform version**:\ \ 9.0.0\n\n" summary: Delete Assessments operationId: v4.delete.assessments.ids tags: - Assessments parameters: - $ref: '#/parameters/authHeaderParam' - description: Comma-delimited IDs of the condition assessments to be deleted in: path name: ids required: true type: string - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{id}/attributes/meta: get: description: "Returns the custom attributes metadata of the condition assessment type. The attributes metadata is configured\ \ for the condition assessment type in Civic Platform Administration.\n\n\n\n**API Endpoint**: GET /v4/assessments/{id}/attributes/meta\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get Attributes Metadata for Condition Assessment Type operationId: v4.get.assessments.id.attributes.meta tags: - Assessments/Attributes parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssessmentPathParam' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_attributeMetadataModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{assessmentId}/documents: get: description: "Returns the documents for a given condition assessment.\n\n\n\n**API Endpoint**: GET /v4/assessments/{assessmentId}/documents\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get All Assessment Documents operationId: v4.get.assessments.assessmentId.documents tags: - Assessments/Documents parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assessmentIdPathParam' - $ref: '#/parameters/limit' - $ref: '#/parameters/offset' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_documentModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. post: description: "Creates one or more document attachments for the given condition assessment. To specify the documents\ \ to be attached, use the HTTP header \"Content-Type:multipart/form-data\" and form-data for \"uploadedFile\" and\ \ \"fileInfo\". Note that the \"fileInfo\" is a string containing an array of file attributes. Use \"fileInfo\" to\ \ specify one or more documents to be attached. For example:\n\n\tContent - Disposition: form - data;name = \"uploadedFile\"\ ; filename=\"summaryReport.pdf\"\n\n\tContent - Disposition: form - data;name = \"fileInfo\"\n\n\t[\n\t\t {\n\t\t\t\ \"serviceProviderCode\": \"BPTDEV\",\n\t\t\t\"fileName\": \"CXA12-pipe.png\",\n\t\t\t\"type\": \"image/png\",\n\t\t\ \t\"description\": \"Condition assessment on pipe\"\n\t\t}\n\t]\n\n\n\n\n\n\n\n**API Endpoint**: POST /v4/assessments/{assessmentId}/documents\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Create Assessment Documents operationId: v4.post.assessments.assessmentId.documents tags: - Assessments/Documents consumes: - multipart/form-data parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assessmentIdPathParam' - description: Specify the filename parameter with the file to be uploaded. See example for details. in: formData name: uploadedFile required: true type: file - description: A string array containing the file metadata for each specified filename. See example for details. in: formData name: fileInfo type: string required: true - description: The document group. in: query name: group type: string - description: The document category. in: query name: category type: string - description: The standard EDMS Adapter userid. It's required for user level authentication in: query name: userId type: string - description: The standard EMDS Adapter password. It's required for user level authentication in: query name: password type: string - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{assessmentId}/documents/{documentIds}: delete: description: "Deletes one or more documents for the given condition assessment.\n\n\n\n**API Endpoint**: DELETE /v4/assessments/{assessmentId}/documents/{documentIds}\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Delete Assessment Documents operationId: v4.delete.assessments.assessmentId.documents.documentIds tags: - Assessments/Documents parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/assessmentIdPathParam' - description: Comma-delimited IDs of the documents to be deleted. in: path name: documentIds required: true type: string - description: The standard EDMS adapter userid. It's required for user level authentication in: query name: userId type: string - description: The standard EDMS adapter password. It's required for user level authentication in: query name: password type: string - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{caId}/records: get: description: "Returns the work order records associated to a given condition assessment.\n\n\n\n**API Endpoint**: GET\ \ /v4/assessments/{caId}/records \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**:\ \ Access token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Get All Records for an Assessment operationId: v4.get.assessments.caId.records tags: - Assessments/Work Orders parameters: - $ref: '#/parameters/authHeaderParam' - description: The ID of the condition assessment to fetch. in: path name: caId required: true type: string - description: Filter by record type. See [Get All Record Types](./api-settings.html#operation/v4.get.settings.records.types). in: query name: type type: string - description: Filter by record status. See [Get All Record Type Statuses](./api-settings.html#operation/v4.get.settings.records.types.id.statuses). in: query name: status type: string - $ref: '#/parameters/limit' - $ref: '#/parameters/offset' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_simpleRecordModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{id}/observations: get: description: "Returns observation data associated to a given condition assessment.\n\n\n\n**API Endpoint**: GET /v4/assessments/{id}/observations\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get Condition Assessment Observations operationId: v4.get.assessments.id.observations tags: - Assessments/Observations parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssessmentPathParam' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_customAttributeModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. put: description: "Creates, updates, and deletes observations for a given condition assessment. Use the {action} field in\ \ the request array item to specify whether the observation is to be created, updated, or deleted. To create or update\ \ an observation, specify the observation custom fields in the fields{} request array item. To determine the observation\ \ custom fields for the given assessment:\n 1.For the requested assessment {id}, get the assessment type.value from\ \ [Get Condition Assessment](./api-assets-assessments.html#operation/v4.get.assessments.id).\n 2. For the assessment\ \ type.value, get the custom field metadata identified by {attributeName} from [Get Observations Metadata for Condition\ \ Assessment Type](./api-assets-assessments.html#operation/v4.get.assessments.id.observations.meta).\n\n\n\n**API\ \ Endpoint**: PUT /v4/assessments/{id}/observations \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization\ \ Type**: Access token \n\n**Civic Platform version**: 9.0.0\n\n" summary: Update Assessment Observations operationId: v4.put.assessments.id.observations tags: - Assessments/Observations parameters: - $ref: '#/parameters/authHeaderParam' - description: The ID of the observation to update in: path name: id required: true type: string - description: Observation information to be updated. in: body name: body required: true schema: items: $ref: '#/definitions/customAttributeModel' type: array - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{id}/observations/meta: get: description: "Returns the custom observations metadata of the condition assessment type. The observations metadata is\ \ configured for the condition assessment type in Civic Platform Administration.\n\n\n\n**API Endpoint**: GET /v4/assessments/{id}/observations/meta\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Get Observations Metadata for Condition Assessment Type operationId: v4.get.assessments.id.observations.meta tags: - Assessments/Observations parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssessmentPathParam' - $ref: '#/parameters/limit' - $ref: '#/parameters/offset' - $ref: '#/parameters/fields' - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_attributeMetadataModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. /v4/assessments/{id}/workorders: post: description: "Adds or links work orders to a given condition assessment.\n\n\n\n**API Endpoint**: POST /v4/assessments/{id}/workorders\ \ \n\n**Scope**: assessments \n\n**App Type**: Agency \n\n**Authorization Type**: Access token \n\n**Civic Platform\ \ version**: 9.0.0\n\n" summary: Add Work Orders to Condition Assessments operationId: v4.post.assessments.id.workorders tags: - Assessments/Work Orders parameters: - $ref: '#/parameters/authHeaderParam' - $ref: '#/parameters/idAssessmentPathParam' - description: An array of work order record IDs to be linked to the assessment. See [Get All Records](./api-records.html#operation/v4.get.records), [Search Records](./api-search.html#operation/v4.post.search.records), or [Get My Records](./api-records.html#operation/v4.get.records.mine). in: body name: relatedRecordIds required: true schema: items: type: string type: array - $ref: '#/parameters/lang' responses: '200': description: 'Successful request. Note: A successful request may return no data matching the filter criteria. A successful request may also return messages related to Event Manager Scripting Engine back-end processing.' schema: $ref: '#/definitions/response_resultModelArray' '400': description: Invalid request. '401': description: Authorization failed. '403': description: Forbidden request. '404': description: Requested resource not found. '500': description: Internal server error or bad connection. definitions: identifierModel: type: object properties: text: description: '' type: string value: description: '' type: string response_attributeMetadataModelArray: type: object properties: result: items: $ref: '#/definitions/attributeMetadataModel' type: array status: type: integer description: The HTTP return status. attributeMetadataModel: type: object properties: attributeGroup: description: The group the attribute belongs to. type: string attributeLabel: description: The attribute's display label. type: string attributeLength: description: The number of characters the attribute field allows. type: string attributeName: description: The unique name of the attribute. This name is for administrative use only; it is not used for display purposes. type: string defaultValue: description: The attribute's default value. type: string description: description: The attribute's description. type: string displayOrder: description: The attribute's display position. format: int64 type: integer displayStatus: description: The attribute's display status. type: string isDropdownList: description: Indicates whether or not the attribute is a dropdown list. enum: - Y - N type: string options: description: Contains the dropdown list values. items: type: string type: array rangeSearchFlag: description: Indicates whether or not the attribute allows a search range. type: string recordStatus: description: Indicates whether or not the attribute is active. type: string searchableFlag: description: Indicates whether or not the attribute is searchable. type: string unitType: description: The unit of measure used with the attribute. type: string updatedBy: description: The user who last updated the attribute. type: string updatedDate: description: The date and time the attribute was last updated. format: date-time type: string valueDataType: description: The data type of the attribute value. type: string valueRequired: description: Indicates whether or not the attribute value is required. type: string response_assetMasterModelArray: type: object properties: result: items: $ref: '#/definitions/assetMasterModel' type: array status: type: integer description: The HTTP return status. assetMasterModel: type: object properties: assetId: description: 'The unique alpha-numeric asset ID in an asset group. **Added in Civic Platform version**: 9.2.0 ' type: string classType: description: "A Class Type is how Civic Platform groups objects that an agency owns or maintains. The five class types\ \ are component, linear, node-link linear, point, and polygon. Asset class types provide the ability to assign or\ \ group multiple asset types together.\t" type: string comments: type: object description: General comments about the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string currentValue: description: The current value of the asset. format: double type: number dateOfService: description: The date the asset was initially placed into service. format: date-time type: string dependentFlag: description: Indicates whether or not the parent asset is dependent on this asset. enum: - Y - N type: string depreciationAmount: description: The decline in the asset value by the asset depreciation calculation. format: double type: number depreciationEndDate: description: The end date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationStartDate: description: The start date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationValue: description: The asset value after the asset depreciation calculation, which is based on the start value, depreciation start and end dates, useful life, and salvage value. format: double type: number description: type: object description: The description of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string endID: description: The ending point asset ID. type: string gisObjects: items: $ref: '#/definitions/gISObjectModel' type: array id: description: The asset system id assigned by the Civic Platform server. format: int64 type: integer name: type: object description: The descriptive name of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string number: description: The unique, alpha-numeric asset ID. type: string salvageValue: description: The residual value of the asset at the end of it’s useful life. format: double type: number serviceProviderCode: description: The unique agency identifier. type: string size: description: A positive numeric value for the asset size. format: double type: number sizeUnit: description: The unit of measure corresponding to the asset size. type: string startID: description: The starting point asset ID. type: string startValue: description: The beginning value or purchase price of the asset. format: double type: number status: type: object description: The status of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string statusDate: description: The date the asset status changed. format: date-time type: string type: type: object description: The type of asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string assetWithAttributesModel: type: object properties: attributeTables: items: $ref: '#/definitions/tableModel' type: array attributes: $ref: '#/definitions/customAttributeModel' classType: description: "A Class Type is how Civic Platform groups objects that an agency owns or maintains. The five class types\ \ are component, linear, node-link linear, point, and polygon. Asset class types provide the ability to assign or\ \ group multiple asset types together.\t" type: string comments: type: object description: General comments about the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string currentValue: description: The current value of the asset. format: double type: number dateOfService: description: The date the asset was initially placed into service. format: date-time type: string dependentFlag: description: Indicates whether or not the parent asset is dependent on this asset. enum: - Y - N type: string depreciationAmount: description: The decline in the asset value by the asset depreciation calculation. format: double type: number depreciationEndDate: description: The end date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationStartDate: description: The start date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationValue: description: The asset value after the asset depreciation calculation, which is based on the start value, depreciation start and end dates, useful life, and salvage value. format: double type: number description: type: object description: The description of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string endID: description: The ending point asset ID. type: string gisObjects: items: $ref: '#/definitions/gISObjectModel' type: array group: type: object description: The asset group. properties: text: description: The localized display value. type: string value: description: The data value. type: string id: description: The asset system id assigned by the Civic Platform server. format: int64 type: integer name: type: object description: The descriptive name of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string number: description: The unique, alpha-numeric asset ID. type: string salvageValue: description: The residual value of the asset at the end of it’s useful life. format: double type: number serviceProviderCode: description: The unique agency identifier. type: string size: description: A positive numeric value for the asset size. format: double type: number sizeUnit: description: The unit of measure corresponding to the asset size. type: string startID: description: The starting point asset ID. type: string startValue: description: The beginning value or purchase price of the asset. format: double type: number status: type: object description: The status of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string statusDate: description: The date the asset status changed. format: date-time type: string type: type: object description: The type of asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string response_assetRelatedModelArray: type: object properties: result: items: $ref: '#/definitions/assetRelatedModel' type: array status: type: integer description: The HTTP return status. assetRelatedModel: type: object properties: assetId: description: 'The unique alpha-numeric asset ID in an asset group. **Added in Civic Platform version**: 9.2.0 ' type: string classType: description: "A Class Type is how Civic Platform groups objects that an agency owns or maintains. The five class types\ \ are component, linear, node-link linear, point, and polygon. Asset class types provide the ability to assign or\ \ group multiple asset types together.\t" type: string comments: type: object description: General comments about the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string currentValue: description: The current value of the asset. format: double type: number dateOfService: description: The date the asset was initially placed into service. format: date-time type: string dependentFlag: description: Indicates whether or not the parent asset is dependent on this asset. enum: - Y - N type: string depreciationAmount: description: The decline in the asset value by the asset depreciation calculation. format: double type: number depreciationEndDate: description: The end date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationStartDate: description: The start date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationValue: description: The asset value after the asset depreciation calculation, which is based on the start value, depreciation start and end dates, useful life, and salvage value. format: double type: number description: type: object description: The description of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string endID: description: The ending point asset ID. type: string gisObjects: items: $ref: '#/definitions/gISObjectModel' type: array group: type: object description: The asset group. properties: text: description: The localized display value. type: string value: description: The data value. type: string hasChild: description: Indicates whether or not the asset has child assets. enum: - Y - N type: string id: description: The asset system id assigned by the Civic Platform server. format: int64 type: integer linkedAssetID: description: The asset ID of the linked asset. type: string linkedAssetSeqNbr: description: The unique sequence id of the linked asset, assigned by the Civic Platform server. format: int64 type: integer name: type: object description: The descriptive name of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string number: description: The unique, alpha-numeric asset ID. type: string salvageValue: description: The residual value of the asset at the end of it’s useful life. format: double type: number serviceProviderCode: description: The unique agency identifier. type: string size: description: A positive numeric value for the asset size. format: double type: number sizeUnit: description: The unit of measure corresponding to the asset size. type: string startID: description: The starting point asset ID. type: string startValue: description: The beginning value or purchase price of the asset. format: double type: number status: type: object description: The status of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string statusDate: description: The date the asset status changed. format: date-time type: string type: type: object description: The type of asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string request_assetUsageModel: type: array items: $ref: '#/definitions/request_assetUsageArray' request_assetUsageArray: type: object properties: usageReading: type: string unitType: type: string response_assetUsageModel: type: object properties: result: items: $ref: '#/definitions/assetUsageArray' type: array status: type: integer description: The HTTP return status. assetUsageArray: type: object properties: id: type: integer isSuccess: type: boolean assetDescriptionModel: type: object properties: description: description: The asset description. type: string group: description: The group the asset belongs to. type: string id: description: The asset system id assigned by the Civic Platform server. type: string status: type: object description: The asset status. properties: text: description: The localized display value. type: string value: description: The data value. type: string type: description: The asset type. type: string gISObjectModel: type: object properties: gisId: description: The GIS object id. type: string layerId: description: The map layer id. type: string serviceId: description: The map service id. type: string tableModel: type: object properties: id: description: The custom table id. type: string rows: items: $ref: '#/definitions/rowModel' description: A table row containing custom fields. type: array rowModel: type: object properties: action: description: The requested operation on the row. enum: - add - update - delete type: string fields: $ref: '#/definitions/customAttributeModel' id: description: The row id. type: string response_assetExtModelArray: type: object properties: result: items: $ref: '#/definitions/assetExtModel' type: array status: type: integer description: The HTTP return status. assetExtModel: type: object properties: assetId: description: 'The unique alpha-numeric asset ID in an asset group. **Added in Civic Platform version**: 9.2.0 ' type: string classType: description: "A Class Type is how Civic Platform groups objects that an agency owns or maintains. The five class types\ \ are component, linear, node-link linear, point, and polygon. Asset class types provide the ability to assign or\ \ group multiple asset types together.\t" type: string comments: type: object description: General comments about the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string currentValue: description: The current value of the asset. format: double type: number dateOfService: description: The date the asset was initially placed into service. format: date-time type: string dependentFlag: description: Indicates whether or not the parent asset is dependent on this asset. enum: - Y - N type: string depreciationAmount: description: The decline in the asset value by the asset depreciation calculation. format: double type: number depreciationEndDate: description: The end date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationStartDate: description: The start date for the asset depreciation calculation. This field is used in the asset depreciation calculation. format: date-time type: string depreciationValue: description: The asset value after the asset depreciation calculation, which is based on the start value, depreciation start and end dates, useful life, and salvage value. format: double type: number description: type: object description: The description of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string endID: description: The ending point asset ID. type: string gisObjects: items: $ref: '#/definitions/gISObjectModel' type: array id: description: The asset system id assigned by the Civic Platform server. format: int64 type: integer name: type: object description: The descriptive name of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string number: description: The unique, alpha-numeric asset ID. type: string records: items: $ref: '#/definitions/simpleRecordModel' type: array salvageValue: description: The residual value of the asset at the end of it’s useful life. format: double type: number serviceProviderCode: description: The unique agency identifier. type: string size: description: A positive numeric value for the asset size. format: double type: number sizeUnit: description: The unit of measure corresponding to the asset size. type: string startID: description: The starting point asset ID. type: string startValue: description: The beginning value or purchase price of the asset. format: double type: number status: type: object description: The status of the asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string statusDate: description: The date the asset status changed. format: date-time type: string type: type: object description: The type of asset. properties: text: description: The localized display value. type: string value: description: The data value. type: string response_assetsRecordsModel: type: object properties: result: items: $ref: '#/definitions/assetsRecordsArray' type: array status: type: integer description: The HTTP return status. assetsRecordsArray: type: object properties: id: type: string page: type: object properties: offset: type: string limit: type: string hasmore: type: boolean records: items: $ref: '#/definitions/recordsArrayInAssetsRecordsArray' type: array recordsArrayInAssetsRecordsArray: type: object properties: name: type: string id: type: string response_simpleRecordModelArray: type: object properties: result: items: $ref: '#/definitions/simpleRecordModel' type: array status: type: integer description: The HTTP return status. simpleRecordModel: type: object properties: actualProductionUnit: description: Estimated cost per production unit. format: double type: number appearanceDate: description: The date for a hearing appearance. format: date-time type: string appearanceDayOfWeek: description: The day for a hearing appearance. type: string assignedDate: description: The date the application was assigned. format: date-time type: string assignedToDepartment: description: The department responsible for the action. See [Get All Departments](./api-settings.html#operation/v4.get.settings.departments). type: string assignedUser: description: The staff member responsible for the action. type: string balance: description: The amount due. format: double type: number booking: description: Indicates whether or not there was a booking in addition to a citation. type: boolean closedByDepartment: description: The department responsible for closing the record. See [Get All Departments](./api-settings.html#operation/v4.get.settings.departments). type: string closedByUser: description: The staff member responsible for closure. type: string closedDate: description: The date the application was closed. format: date-time type: string completedByDepartment: description: The department responsible for completion. See [Get All Departments](./api-settings.html#operation/v4.get.settings.departments). type: string completedByUser: description: The staff member responsible for completion. type: string completedDate: description: The date the application was completed. format: date-time type: string constructionType: type: object description: The US Census Bureau construction type code. See [Get All Record Construction Types](./api-settings.html#operation/v4.get.settings.records.constructionTypes). properties: text: description: The localized display value. type: string value: description: The data value. type: string costPerUnit: description: The cost for one unit associated to the record. format: double type: number createdBy: description: The unique user id of the individual that created the entry. type: string createdByCloning: description: Indictes whether or not the record was cloned. enum: - Y - N type: string customId: description: An ID based on a different numbering convention from the numbering convention used by the record ID (xxxxx-xx-xxxxx). Civic Platform auto-generates and applies an alternate ID value when you submit a new application. type: string defendantSignature: description: Indicates whether or not a defendant's signature has been obtained. type: boolean description: description: The description of the record or item. type: string enforceDepartment: description: The name of the department responsible for enforcement. See [Get All Departments](./api-settings.html#operation/v4.get.settings.departments). type: string enforceUser: description: Name of the enforcement officer. type: string enforceUserId: description: ID number of the enforcement officer. type: string estimatedCostPerUnit: description: The estimated cost per unit. format: double type: number estimatedDueDate: description: The estimated date of completion. format: date-time type: string estimatedProductionUnit: description: The estimated number of production units. format: double type: number estimatedTotalJobCost: description: The estimated cost of the job. format: double type: number firstIssuedDate: description: The first issued date for license format: date-time type: string housingUnits: description: The number of housing units. format: int64 type: integer id: description: The record system id assigned by the Civic Platform server. type: string infraction: description: Indicates whether or not an infraction occurred. type: boolean initiatedProduct: description: 'The Civic Platform product where the application is submitted: "AA" : Classic Accela Automation. "ACA" : Accela Citizen Access. "AIVR" : Accela Integrated Voice Response. "AMO" : Accela Mobile Office. "AV360" : Accela Asset Management, Accela Land Management.' type: string inPossessionTime: description: The application level in possession time of the time tracking feature. format: double type: number inspectorDepartment: description: The name of the department where the inspector works. See [Get All Departments](./api-settings.html#operation/v4.get.settings.departments). type: string inspectorId: description: The ID number of the inspector. See [Get All Inspectors](./api-inspections.html#operation/v4.get.inspectors). type: string inspectorName: description: The name of the inspector. See [Get All Inspectors](./api-inspections.html#operation/v4.get.inspectors). type: string jobValue: description: The value of the job. format: double type: number misdemeanor: description: Indicates whether or not a misdemeanor occurred. type: boolean module: description: The module the record belongs to. See [Get All Modules](./api-settings.html#operation/v4.get.settings.modules). type: string name: description: The name associated to the record. type: string numberOfBuildings: description: The number of buildings. format: int64 type: integer offenseWitnessed: description: Indicates whether or not there was a witness to the alleged offense. type: boolean openedDate: description: The date the application was opened. format: date-time type: string overallApplicationTime: description: The amount of elapsed time from the time tracking start date to the completion of the application. format: double type: number priority: type: object description: The priority level assigned to the record. See [Get All Priorities](./api-settings.html#operation/v4.get.settings.priorities). properties: text: description: The localized display value. type: string value: description: The data value. type: string publicOwned: description: Indicates whether or not the record is for the public. type: boolean recordClass: description: General information about the record. type: string renewalInfo: $ref: '#/definitions/recordExpirationModel' reportedChannel: type: object description: The incoming channel through which the applicant submitted the application. properties: text: description: The localized display value. type: string value: description: The data value. type: string reportedDate: description: The date the complaint was reported. format: date-time type: string reportedType: type: object description: The type of complaint or incident being reported. properties: text: description: The localized display value. type: string value: description: The data value. type: string scheduledDate: description: The date when the inspection gets scheduled. format: date-time type: string serviceProviderCode: description: The unique agency identifier, type: string severity: type: object description: Indicates the severity of the condition. properties: text: description: The localized display value. type: string value: description: The data value. type: string shortNotes: description: A brief note about the record subject. type: string status: type: object description: The record status. properties: text: description: The localized display value. type: string value: description: The data value. type: string statusDate: description: "The date when the current status changed.\t" format: date-time type: string statusReason: type: object description: "\tThe reason for the status setting on the record." properties: text: description: The localized display value. type: string value: description: The data value. type: string statusType: description: The record status type. enum: - APPROVED - CLOSED - COMPLETE - DENIED - INCOMPLETE - OPEN - PENDING - UNASSIGNED - VOID type: string totalFee: description: The total amount of the fees invoiced to the record. format: double type: number totalJobCost: description: The combination of work order assignments (labor) and costs. format: double type: number totalPay: description: The total amount of pay. format: double type: number trackingId: description: The application tracking number (IVR tracking number). format: int64 type: integer type: $ref: '#/definitions/recordTypeModel' undistributedCost: description: The undistributed costs for this work order. format: double type: number updateDate: description: The date the record was last updated. format: date-time type: string value: description: The record value. type: string recordExpirationModel: type: object properties: expirationDate: description: The date when the condition expires. format: date-time type: string expirationStatus: type: object description: Indicates whether the expiration is enabled or disabled. See [Get All Record Expiration Statuses](./api-settings.html#operation/v4.get.settings.records.expirationStatuses). properties: text: description: The localized display value. type: string value: description: The data value. type: string recordTypeModel: type: object properties: alias: description: The record type alias. type: string category: description: The 4th level in a 4-level record type structure (Group-Type-Subtype-Category). type: string filterName: description: The name of the record type filter which defines the record types to be displayed for the citizen user. type: string group: description: The 1st level in a 4-level record type structure (Group-Type-Subtype-Category). type: string id: description: The record type id. type: string module: description: The module the record type belongs to. type: string subType: description: The 3rd level in a 4-level record type structure (Group-Type-Subtype-Category). type: string text: description: The localized display text. type: string type: description: The 2nd level in a 4-level record type structure (Group-Type-Subtype-Category). type: string value: description: The stored value. type: string response_resultModelArray: type: object properties: result: items: $ref: '#/definitions/resultModel' type: array status: type: integer description: The HTTP return status. response_resultModel: type: object properties: result: $ref: '#/definitions/resultModel' status: type: integer description: The HTTP return status. resultModel: type: object properties: code: description: The error code, if an error is encountered. type: string id: description: The system id of the object in this operation. format: int64 type: integer isSuccess: description: Indicates whether or not the operation on the object is successful. type: boolean message: description: The error message, if an error is encountered type: string request_assessmentModel: type: object required: - status properties: attributes: $ref: '#/definitions/customAttributeModel' comment: description: Comments or notes about the assessment. type: string conditionAssessment: description: The condition assessment type. See [Get All Condition Assessment Types](./api-settings.html#operation/v4.get.settings.assessments.types). type: string inspectionDate: description: The inspection date for the assessment, in yyyy-mm-dd format. type: string inspectionTime: description: The inspection time for the assessment, in hh:mm AM/PM format. type: string inspectorId: description: The ID of the inspector. See [Get All Inspectors](./api-inspections.html#operation/v4.get.inspectors). type: string scheduleDate: description: The scheduled assessment date, in yyyy-mm-dd format. type: string scheduleTime: description: The scheduled assessment time, in hh:mm AM/PM format. type: string status: description: The status of the condition assessment enum: - Completed - Scheduled type: string timeSpent: description: The number of hours spent on the assessment. type: string response_customAttributeModelArray: type: object properties: result: items: $ref: '#/definitions/customAttributeModel' type: array status: type: integer description: The HTTP return status. customAttributeModel: type: object properties: aCustomFieldName: description: The name of a custom field. type: string aCustomFieldValue: description: The value of a custom field. type: string response_assetConditionAssessmentModelArray: type: object properties: result: items: $ref: '#/definitions/assetConditionAssessmentModel' type: array status: type: integer description: The HTTP return status. assetConditionAssessmentModel: type: object properties: asset: $ref: '#/definitions/assetDescriptionModel' assetCAID: description: The asset condition assessment ID. format: int64 type: integer assignedToDepartment: description: The department responsible for the assessment. type: string attributes: $ref: '#/definitions/customAttributeModel' comments: description: The name of the inspector performing the assessment. type: string inspectorFullName: description: The unique identifier of the inspector. type: string inspectorId: description: The inspector id. type: string scheduledDate: description: The scheduled assessment date, in yyyy-mm-dd format. format: date-time type: string scheduledTime: description: The scheduled assessment time, in hh:mm AM/PM format. type: string status: description: The assessment status. type: string timeSpent: description: The number of hours spent on the assessment. format: double type: number type: description: The type of assessment. type: string response_documentModelArray: type: object properties: result: items: $ref: '#/definitions/documentModel' type: array status: type: integer description: The HTTP return status. documentModel: type: object properties: category: type: object description: The document category. The list of category options varies depending on the document group. properties: text: description: The localized display value. type: string value: description: The data value. type: string deletable: description: Contains permission assignments for deleting documents. $ref: '#/definitions/userRolePrivilegeModel' department: description: The name of the department the document belongs to. type: string description: description: The document description. type: string downloadable: description: Contains permission assignments for downloading documents. $ref: '#/definitions/userRolePrivilegeModel' entityId: description: The unique ID of the entity or record. type: string entityType: description: The type of entity. type: string fileName: description: The name of the file as it displays in the source location. type: string group: type: object description: The document group. properties: text: description: The localized display value. type: string value: description: The data value. type: string id: description: The document id. format: int64 type: integer modifiedBy: description: The user account that last modified the document. type: string modifiedDate: description: The date the document was last modified. format: date-time type: string serviceProviderCode: description: The unique agency identifier. type: string size: description: The file size of the document. format: double type: number source: description: The name for your agency's electronic document management system. type: string status: type: object description: The documet status. properties: text: description: The localized display value. type: string value: description: The data value. type: string statusDate: description: The date when the current status changed. format: date-time type: string titleViewable: description: Contains permission assignments for viewing document names. $ref: '#/definitions/userRolePrivilegeModel' type: description: The document type. type: string uploadedBy: description: The user who uploaded the document to the record. type: string uploadedDate: description: The date when the document was uploaded. format: date-time type: string virtualFolders: description: This is the virtual folder for storing the attachment. With virtual folders you can organize uploaded attachments in groups type: string userRolePrivilegeModel: type: object properties: contactAllowed: description: Indicates whether or not the permission is given to a contact. type: boolean deleteAllowed: description: "Indicates whether or not the permission to delete a document is allowed.\t" type: boolean downloadAllowed: description: Indicates whether or not the permission to download a document is allowed. type: boolean licenseTypeRules: items: type: string description: "A string array containing the types of licensed professionals who are given the permission.\t" type: array licensendProfessionalAllowed: description: Indicates whether or not the permission is given to a licensed professional. type: boolean ownerAllowed: description: Indicates whether or not the permission is given to an owner. type: boolean recordCreatorAllowed: description: Indicates whether or not the permission is given to a record creator. type: boolean registeredUserAllowed: description: Indicates whether or not the permission is given to a registered public user. type: boolean titleViewAllowed: description: Indicates whether or not the permission to view a document name is allowed. type: boolean uploadAllowed: description: Indicates whether or not the permission to upload a document is allowed. type: boolean parameters: authHeaderParam: description: Construct oAuth2 authentication token in: header name: Authorization required: true type: string offset: description: The offset position of the first record in the results response array. For example, if offset is 100, the first item in the results array in the response is the 100th record in the search result list. format: int64 in: query name: offset required: false type: integer limit: description: Search result size limit. format: int64 in: query name: limit required: false type: integer fields: description: Comma-delimited names of fields to be returned in the response. Note - Field names are case-sensitive and only first-level fields are supported. Invalid field names are ignored. in: query name: fields required: false type: string lang: description: Language parameter to support I18N. Default language is en_US. in: query name: lang required: false type: string assetIdPathParam: description: The ID of the asset to fetch. See [Get All Assets](./api-assets-assessments.html#operation/v4.get.assets). in: path name: assetId required: true type: string idAssetPathParam: description: The ID of the asset to fetch. See [Get All Assets](./api-assets-assessments.html#operation/v4.get.assets). in: path name: id required: true type: string assetIdQueryParam: description: Filter by asset ID. in: query name: assetId type: string assessmentIdPathParam: description: The ID of the assessment to fetch. in: path name: assessmentId required: true type: string idAssessmentPathParam: description: The ID of the condition assessment to fetch. in: path name: id required: true type: string x-api-evangelist-provenance: generated: '2026-09-06' method: searched source: https://developer.accela.com/api/v4/v4-assets-assessments.json note: Harvested verbatim from the Accela Developer Portal API Reference, which renders these Swagger 2.0 documents via ReDoc (spec-url on developer.accela.com/docs/api_reference/api-*.html). The byte-identical original is kept at openapi/_original/. This copy is the same document serialized to YAML.