> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clemta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Fixed Assets

> Retrieve a list of fixed assets with filtering and pagination

# List Fixed Assets

This endpoint allows you to retrieve a list of fixed assets for a company with optional filtering and pagination.

## Headers

| Parameter | Type   | Description                  |
| --------- | ------ | ---------------------------- |
| X-API-KEY | string | Formation API Key (required) |

## Query Parameters

| Parameter                       | Type   | Required | Description                              |
| ------------------------------- | ------ | -------- | ---------------------------------------- |
| company\_id                     | string | Yes      | Company ID to filter fixed assets        |
| skip                            | string | No       | Number of records to skip (pagination)   |
| limit                           | string | No       | Number of records to return (pagination) |
| search                          | string | No       | Search term to filter fixed assets       |
| sort                            | string | No       | Field to sort by                         |
| order                           | string | No       | Sort order: "asc" or "desc"              |
| fixed\_asset\_number            | string | No       | Fixed asset number filter                |
| fixed\_asset\_number\_value     | string | No       | Fixed asset number value                 |
| title                           | string | No       | Title filter                             |
| title\_value                    | string | No       | Title value                              |
| placed\_in\_service             | string | No       | Placed in service filter                 |
| placed\_in\_service\_value      | string | No       | Placed in service value (timestamp)      |
| end\_placed\_in\_service\_value | string | No       | End placed in service value (timestamp)  |
| cost                            | string | No       | Cost filter                              |
| cost\_value                     | string | No       | Cost value                               |
| end\_cost\_value                | string | No       | End cost value                           |
| salvage\_value                  | string | No       | Salvage value filter                     |
| salvage\_value\_value           | string | No       | Salvage value                            |
| end\_salvage\_value             | string | No       | End salvage value                        |
| business\_use                   | string | No       | Business use filter                      |
| business\_use\_value            | string | No       | Business use value                       |
| end\_business\_use\_value       | string | No       | End business use value                   |
| created\_at                     | string | No       | Created at filter                        |
| created\_at\_value              | string | No       | Created at value (timestamp)             |
| end\_date                       | string | No       | End date value (timestamp)               |

### Parameter Examples

* **Basic request**: `GET /fixed-assets?company_id=64b8f1a2e4b0c8d9f0123456`
* **With pagination**: `GET /fixed-assets?company_id=64b8f1a2e4b0c8d9f0123456&skip=0&limit=10`
* **With search**: `GET /fixed-assets?company_id=64b8f1a2e4b0c8d9f0123456&search=computer`
* **With sorting**: `GET /fixed-assets?company_id=64b8f1a2e4b0c8d9f0123456&sort=created_at&order=desc`
* **With cost filter**: `GET /fixed-assets?company_id=64b8f1a2e4b0c8d9f0123456&cost=cost_value&cost_value=1000&end_cost_value=2000`

## Response

```json theme={null}
{
  "success": true,
  "message": "Fixed assets retrieved successfully",
  "data": {
    "fixed_assets": [
      {
        "id": "64b8f1a2e4b0c8d9f0123456",
        "title": "Office Computer",
        "placed_in_service": 1640995200,
        "cost": 1500.0,
        "salvage_value": 150.0,
        "business_use": 100.0,
        "fixed_asset_number": 1,
        "fixed_asset_number_text": "AST-1",
        "created_at": 1640995200,
        "updated_at": 1640995200
      },
      {
        "id": "64b8f1a2e4b0c8d9f0123457",
        "title": "Office Desk",
        "placed_in_service": 1640995200,
        "cost": 800.0,
        "salvage_value": 80.0,
        "business_use": 100.0,
        "fixed_asset_number": 2,
        "fixed_asset_number_text": "AST-2",
        "created_at": 1640995200,
        "updated_at": 1640995200
      }
    ],
    "total": 2
  }
}
```

### Response Parameters

| Parameter          | Type    | Description                                |
| ------------------ | ------- | ------------------------------------------ |
| success            | boolean | Indicates if the operation was successful  |
| message            | string  | Additional information about the operation |
| data               | object  | Response data for successful requests      |
| data.fixed\_assets | array   | Array of fixed asset objects               |
| data.total         | integer | Total number of fixed assets               |

### Fixed Asset Object Parameters

| Parameter                  | Type    | Description                                |
| -------------------------- | ------- | ------------------------------------------ |
| id                         | string  | Unique identifier for the fixed asset      |
| title                      | string  | Title/name of the fixed asset              |
| placed\_in\_service        | integer | Timestamp when asset was placed in service |
| cost                       | number  | Original cost of the fixed asset           |
| salvage\_value             | number  | Estimated salvage value of the asset       |
| business\_use              | number  | Percentage of business use (0-100)         |
| fixed\_asset\_number       | integer | Auto-generated fixed asset number          |
| fixed\_asset\_number\_text | string  | Formatted fixed asset number text          |
| created\_at                | integer | Creation timestamp                         |
| updated\_at                | integer | Last update timestamp                      |

## Error Responses

### Invalid Request (400)

```json theme={null}
{
  "success": false,
  "message": "Invalid request",
  "error": {
    "code": "INVALID_REQUEST",
    "details": "Company ID is required"
  }
}
```

### Unauthorized (401)

```json theme={null}
{
  "success": false,
  "message": "API key is required",
  "error": {
    "code": "API_KEY_REQUIRED",
    "details": ""
  }
}
```

### Company Not Found (404)

```json theme={null}
{
  "success": false,
  "message": "Company not found",
  "error": {
    "code": "COMPANY_NOT_FOUND",
    "details": ""
  }
}
```

### Internal Server Error (500)

```json theme={null}
{
  "success": false,
  "message": "Internal server error",
  "error": {
    "code": "INTERNAL_ERROR",
    "details": "An unexpected error occurred."
  }
}
```

## Notes

* The `company_id` parameter is required for all requests
* Pagination parameters (`skip` and `limit`) are optional but recommended for large datasets
* Search functionality works across title and description fields
* Timestamp filters should be provided in Unix timestamp format
* Cost and salvage value filters support range queries using `_value` and `end_` parameters


## OpenAPI

````yaml GET /fixed-assets
openapi: 3.0.3
info:
  title: Clemta Formation API
  description: >-
    API for company formation services. This API allows partners to create,
    retrieve, and manage company formations programmatically.
  version: '2025-06-24'
  contact:
    name: Clemta API Support
    email: tech@clemta.com
  license:
    name: Proprietary
    url: https://clemta.com/terms
servers:
  - url: https://api.clemta.com
    description: Production server
  - url: https://sandbox.clemta.com
    description: Sandbox server
security:
  - ApiKeyAuth: []
paths:
  /fixed-assets:
    get:
      tags:
        - Fixed Assets
      summary: Get Fixed Assets
      description: >-
        Retrieves a list of fixed assets for a company with optional filtering
        and pagination
      operationId: getFixedAssets
      parameters:
        - name: company_id
          in: query
          required: true
          description: Company ID
          schema:
            type: string
        - name: skip
          in: query
          required: false
          description: Number of records to skip
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Number of records to return
          schema:
            type: string
        - name: search
          in: query
          required: false
          description: Search term
          schema:
            type: string
        - name: sort
          in: query
          required: false
          description: Sort field
          schema:
            type: string
        - name: order
          in: query
          required: false
          description: Sort order (asc/desc)
          schema:
            type: string
            enum:
              - asc
              - desc
        - name: fixed_asset_number
          in: query
          required: false
          description: Fixed asset number filter
          schema:
            type: string
        - name: fixed_asset_number_value
          in: query
          required: false
          description: Fixed asset number value
          schema:
            type: string
        - name: title
          in: query
          required: false
          description: Title filter
          schema:
            type: string
        - name: title_value
          in: query
          required: false
          description: Title value
          schema:
            type: string
        - name: placed_in_service
          in: query
          required: false
          description: Placed in service filter
          schema:
            type: string
        - name: placed_in_service_value
          in: query
          required: false
          description: Placed in service value (timestamp)
          schema:
            type: string
        - name: end_placed_in_service_value
          in: query
          required: false
          description: End placed in service value (timestamp)
          schema:
            type: string
        - name: cost
          in: query
          required: false
          description: Cost filter
          schema:
            type: string
        - name: cost_value
          in: query
          required: false
          description: Cost value
          schema:
            type: string
        - name: end_cost_value
          in: query
          required: false
          description: End cost value
          schema:
            type: string
        - name: salvage_value
          in: query
          required: false
          description: Salvage value filter
          schema:
            type: string
        - name: salvage_value_value
          in: query
          required: false
          description: Salvage value
          schema:
            type: string
        - name: end_salvage_value
          in: query
          required: false
          description: End salvage value
          schema:
            type: string
        - name: business_use
          in: query
          required: false
          description: Business use filter
          schema:
            type: string
        - name: business_use_value
          in: query
          required: false
          description: Business use value
          schema:
            type: string
        - name: end_business_use_value
          in: query
          required: false
          description: End business use value
          schema:
            type: string
        - name: created_at
          in: query
          required: false
          description: Created at filter
          schema:
            type: string
        - name: created_at_value
          in: query
          required: false
          description: Created at value (timestamp)
          schema:
            type: string
        - name: end_date
          in: query
          required: false
          description: End date value (timestamp)
          schema:
            type: string
      responses:
        '200':
          description: Fixed assets retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FixedAssetListResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '404':
          description: Company not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
components:
  schemas:
    FixedAssetListResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Fixed assets retrieved successfully
        data:
          type: object
          properties:
            fixed_assets:
              type: array
              items:
                $ref: '#/components/schemas/FixedAssetResponse'
            total:
              type: integer
              description: Total number of fixed assets
    BadRequestError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Invalid request data
        data:
          type: object
          nullable: true
          example: null
        error:
          type: object
          properties:
            code:
              type: string
              example: INVALID_REQUEST
            details:
              type: string
              example: Field 'name' is required
    UnauthorizedError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: API key is required
        data:
          type: object
          nullable: true
          example: null
        error:
          type: object
          properties:
            code:
              type: string
              example: API_KEY_REQUIRED
            details:
              type: string
              example: ''
    NotFoundError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Company not found
        data:
          type: object
          nullable: true
          example: null
        error:
          type: object
          properties:
            code:
              type: string
              example: COMPANY_NOT_FOUND
            details:
              type: string
              example: ''
    InternalServerError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Internal server error
        data:
          type: object
          nullable: true
          example: null
        error:
          type: object
          properties:
            code:
              type: string
              example: INTERNAL_ERROR
            details:
              type: string
              example: An unexpected error occurred.
    FixedAssetResponse:
      type: object
      example:
        id: 64b8f1a2e4b0c8d9f0123456
        created_at: 1640995200
        updated_at: 1640995200
        title: Office Computer
        placed_in_service: 1640995200
        cost: 1500
        salvage_value: 150
        business_use: 100
        fixed_asset_number: 1
        fixed_asset_number_text: AST-1
      properties:
        id:
          type: string
          description: Fixed asset ID
        created_at:
          type: integer
          description: Creation timestamp
        updated_at:
          type: integer
          description: Last update timestamp
        title:
          type: string
          description: Title/name of the fixed asset
        placed_in_service:
          type: integer
          description: Timestamp when the asset was placed in service
        cost:
          type: number
          description: Original cost of the fixed asset
        salvage_value:
          type: number
          description: Estimated salvage value of the asset
        business_use:
          type: number
          description: Percentage of business use (0-100)
        fixed_asset_number:
          type: integer
          description: Auto-generated fixed asset number
        fixed_asset_number_text:
          type: string
          description: Formatted fixed asset number text
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Formation API key for authentication.

````