> ## Documentation Index > Fetch the complete documentation index at: https://docs.layerfi.com/llms.txt > Use this file to discover all available pages before exploring further. # List asset value updates > Returns a list of value updates across all assets for the specified business. Results are paginated; see [Pagination](/api-details/pagination) for details. ## OpenAPI ````yaml get /v1/businesses/{businessId}/assets/value-updates openapi: 3.0.1 info: title: API version: latest servers: [] security: - BearerAuth: [] tags: [] externalDocs: url: / paths: /v1/businesses/{businessId}/assets/value-updates: get: tags: [] summary: List asset value updates description: >- Returns a list of value updates across all assets for the specified business. Results are paginated; see [Pagination](/api-details/pagination) for details. operationId: business.assets.valueUpdates.get parameters: - name: businessId in: path description: The UUID of the business. required: true schema: type: string format: uuid - name: sort_by in: query required: false description: Field to sort by. Defaults to `date`. schema: type: string default: date - name: sort_order in: query required: false description: Sort direction. Defaults to `ASC`. schema: type: string enum: - ASC - DESC default: ASC - name: cursor in: query required: false description: >- Pagination cursor returned by the previous list request. Omit for the first page. schema: type: string - name: limit in: query required: false description: Maximum number of results to return. Defaults to 100. schema: type: integer default: 100 - name: show_total_count in: query required: false description: >- If true, include `total_count` in the pagination metadata. Has a performance cost; defaults to false. schema: type: boolean default: false responses: '200': description: A list of asset value updates. content: application/json: schema: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/ApiAssetValueUpdate' meta: $ref: '#/components/schemas/RequestMetadata' components: schemas: ApiAssetValueUpdate: type: object description: >- A recorded change to an asset's value, such as depreciation, improvement, impairment, or revaluation. required: - id - business_id - asset_id - amount - update_type - date - transaction_tags properties: id: type: string format: uuid description: Unique identifier for the value update. business_id: type: string format: uuid description: ID of the business that owns the asset. external_id: type: string nullable: true description: Unique ID of the value update in your system for linking purposes. asset_id: type: string format: uuid description: ID of the asset this value update applies to. amount: type: integer format: int64 description: Amount of the value change, in cents. update_type: $ref: '#/components/schemas/AssetValueUpdateType' date: type: string format: date-time description: Date of the value update. archived_at: type: string format: date-time nullable: true description: When the value update was archived, if applicable. memo: type: string nullable: true description: Internal note about the value update. metadata: type: object additionalProperties: true nullable: true description: >- Arbitrary JSON object you can attach for your own use. Layer stores and returns it unchanged. reference_number: type: string nullable: true description: Reference number for the value update. transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' description: Tags applied to this record. RequestMetadata: type: object description: Request metadata. Present on paginated list responses. properties: type: type: string description: Metadata type discriminator. Value will be `request_metadata`. example: request_metadata pagination: $ref: '#/components/schemas/PaginationMetadata' AssetValueUpdateType: type: string description: >- The kind of value change applied to an asset. `DEPRECIATION_AMORTIZATION`, `IMPAIRMENT`, and `REVALUATION_DOWN` decrease the asset's carrying value; `IMPROVEMENT` and `REVALUATION_UP` increase it. `DEPRECIATION_AMORTIZATION` requires the asset to have an `accumulated_depreciation_account` configured. enum: - DEPRECIATION_AMORTIZATION - IMPROVEMENT - IMPAIRMENT - REVALUATION_UP - REVALUATION_DOWN ApiTag: type: object properties: id: type: string format: uuid description: ID for the tag. key: type: string description: Key for the tag. example: ExampleTagKey dimension_display_name: type: string nullable: true description: Display name for the tag dimension. value: type: string description: Value for the tag. example: ExampleTagValue value_display_name: type: string nullable: true description: Display name for the tag value definition. dimension_id: type: string format: uuid description: ID of the tag dimension this tag belongs to. definition_id: type: string format: uuid description: ID of the tag value definition. archived_at: type: string format: date-time nullable: true description: When the tag was archived. required: - id - key - value - dimension_id - definition_id PaginationMetadata: type: object description: >- Cursor-based pagination metadata returned alongside paginated list responses. properties: sort_by: type: string nullable: true description: Field the result set is sorted by. sort_order: type: string enum: - ASC - DESC description: Sort direction applied to the result set. cursor: type: string nullable: true description: >- Opaque cursor to pass as `pagination_cursor` to fetch the next page. Null when there are no further pages. has_more: type: boolean description: Whether additional pages are available after the current one. total_count: type: integer format: int64 nullable: true description: Total number of records across all pages, when available. required: - sort_by - sort_order - cursor - has_more securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````