---
updatedAt: 2025-06-05T21:59:24.000Z
agentTools:
  projectIndex: https://developer.bluetally.com/llms.txt
---

# List Maintenances

Returns all maintenances.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "bluetally-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://app.bluetallyapp.com/api/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/maintenances": {
      "get": {
        "summary": "List Maintenances",
        "description": "Returns all maintenances.",
        "operationId": "list-maintenances",
        "parameters": [
          {
            "name": "tenant_id",
            "in": "query",
            "description": "The ID of the tenant the API request is for (for users with multi-tenancy enabled)",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of entries to return.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "The column to sort the results by. Options: { created_at, updated_at, type, name, start_date, end_date, cost, notes }",
            "schema": {
              "type": "string",
              "default": "name"
            }
          },
          {
            "name": "order",
            "in": "query",
            "description": "The order to sort the results by. Options: { asc, desc }",
            "schema": {
              "type": "string",
              "default": "asc"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Offset the results by a number.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "The exact search for type. Options: { maintenance, repair, upgrade, test, calibration, hardware support, software support }",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "The exact search for name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "The exact search start date. Format: YYYY-MM-DD",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "The exact search for end date. Format: YYYY-MM-DD",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cost",
            "in": "query",
            "description": "The exact search for cost.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "asset_id",
            "in": "query",
            "description": "The exact search for asset id.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "supplier_id",
            "in": "query",
            "description": "The exact search for supplier id.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "notes",
            "in": "query",
            "description": "The exact search for notes.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "[\n  {\n    \"id\": 331622260,\n    \"type\": \"Maintenance\",\n    \"name\": \"Changed screen\",\n    \"start_date\": \"2024-08-08\",\n    \"end_date\": \"2025-01-01\",\n    \"cost\": 978,\n    \"asset_id\": 128425376,\n    \"supplier_id\": 56954465,\n    \"notes\": \"\",\n    \"created_at\": \"2024-08-15T16:43:51.190Z\",\n    \"updated_at\": \"2024-08-15T16:43:51.190Z\"\n  },\n  {\n    \"id\": 608609348,\n    \"type\": \"Upgrade\",\n    \"name\": \"Changed screen\",\n    \"start_date\": \"2024-08-08\",\n    \"end_date\": \"2025-01-01\",\n    \"cost\": 517,\n    \"asset_id\": 393662115,\n    \"supplier_id\": 103101594,\n    \"notes\": \"\",\n    \"created_at\": \"2024-08-15T16:43:51.181Z\",\n    \"updated_at\": \"2024-08-15T16:43:51.181Z\"\n  }\n]"
                  }
                },
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "example": 331622260,
                        "default": 0
                      },
                      "type": {
                        "type": "string",
                        "example": "Maintenance"
                      },
                      "name": {
                        "type": "string",
                        "example": "Changed screen"
                      },
                      "start_date": {
                        "type": "string",
                        "example": "2024-08-08"
                      },
                      "end_date": {
                        "type": "string",
                        "example": "2025-01-01"
                      },
                      "cost": {
                        "type": "integer",
                        "example": 978,
                        "default": 0
                      },
                      "asset_id": {
                        "type": "integer",
                        "example": 128425376,
                        "default": 0
                      },
                      "supplier_id": {
                        "type": "integer",
                        "example": 56954465,
                        "default": 0
                      },
                      "notes": {
                        "type": "string",
                        "example": ""
                      },
                      "created_at": {
                        "type": "string",
                        "example": "2024-08-15T16:43:51.190Z"
                      },
                      "updated_at": {
                        "type": "string",
                        "example": "2024-08-15T16:43:51.190Z"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```