--- updatedAt: 2026-08-06T21:05:39.000Z agentTools: projectIndex: https://snipe-it.readme.io/llms.txt --- # /maintenances List asset maintenances # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "snipe-it-rest-api", "version": "8.2.0" }, "servers": [ { "url": "https://develop.snipeitapp.com/api/v1" } ], "security": [ {} ], "paths": { "/maintenances": { "get": { "summary": "/maintenances", "description": "List asset maintenances", "operationId": "maintenances", "parameters": [ { "name": "limit", "in": "query", "description": "Number of results to return", "schema": { "type": "integer", "format": "int32", "default": 50 } }, { "name": "offset", "in": "query", "description": "Offset to use when retrieving results (useful in pagination)", "schema": { "type": "integer", "format": "int32", "default": 0 } }, { "name": "search", "in": "query", "description": "Search string", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "Field to order by", "schema": { "type": "string", "default": "created_at" } }, { "name": "order", "in": "query", "description": "Sort order (asc or desc)", "schema": { "type": "string" } }, { "name": "asset_id", "in": "query", "description": "Asset ID of the asset you'd like to return maintenances for", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"total\": 2,\n \"rows\": [\n {\n \"id\": 2,\n \"asset\": {\n \"id\": 1,\n \"name\": \"Test Name\",\n \"asset_tag\": \"02948\"\n },\n \"title\": \"Test with all fields\",\n \"location\": {\n \"id\": 3,\n \"name\": \"East Pollyville\"\n },\n \"notes\": \"This is a test\",\n \"supplier\": {\n \"id\": 3,\n \"name\": \"Effertz, Langworth and Prohaska\"\n },\n \"cost\": \"100.00\",\n \"asset_maintenance_type\": \"Repair\",\n \"start_date\": {\n \"datetime\": \"2018-03-06 00:00:00\",\n \"formatted\": \"Tue Mar 06, 2018 12:00AM\"\n },\n \"asset_maintenance_time\": 20,\n \"completion_date\": {\n \"datetime\": \"2018-03-26 00:00:00\",\n \"formatted\": \"Mon Mar 26, 2018 12:00AM\"\n },\n \"user_id\": {\n \"id\": 2,\n \"name\": \"Snipe E. Head\"\n },\n \"created_at\": {\n \"datetime\": \"2018-03-26 17:43:35\",\n \"formatted\": \"Mon Mar 26, 2018 5:43PM\"\n },\n \"updated_at\": {\n \"datetime\": \"2018-03-26 17:43:35\",\n \"formatted\": \"Mon Mar 26, 2018 5:43PM\"\n },\n \"available_actions\": {\n \"update\": true,\n \"delete\": true\n }\n },\n {\n \"id\": 1,\n \"asset\": {\n \"id\": 1,\n \"name\": \"Test Name\",\n \"asset_tag\": \"02948\"\n },\n \"title\": \"adfasasd\",\n \"location\": {\n \"id\": 3,\n \"name\": \"East Pollyville\"\n },\n \"notes\": null,\n \"supplier\": {\n \"id\": 3,\n \"name\": \"Effertz, Langworth and Prohaska\"\n },\n \"cost\": null,\n \"asset_maintenance_type\": \"Maintenance\",\n \"start_date\": {\n \"datetime\": \"2018-03-01 00:00:00\",\n \"formatted\": \"Thu Mar 01, 2018 12:00AM\"\n },\n \"asset_maintenance_time\": null,\n \"completion_date\": null,\n \"user_id\": {\n \"id\": 2,\n \"name\": \"Snipe E. Head\"\n },\n \"created_at\": {\n \"datetime\": \"2018-03-26 15:28:19\",\n \"formatted\": \"Mon Mar 26, 2018 3:28PM\"\n },\n \"updated_at\": {\n \"datetime\": \"2018-03-26 15:28:19\",\n \"formatted\": \"Mon Mar 26, 2018 3:28PM\"\n },\n \"available_actions\": {\n \"update\": true,\n \"delete\": true\n }\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 2, "default": 0 }, "rows": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 2, "default": 0 }, "asset": { "type": "object", "properties": { "id": { "type": "integer", "example": 1, "default": 0 }, "name": { "type": "string", "example": "Test Name" }, "asset_tag": { "type": "string", "example": "02948" } } }, "title": { "type": "string", "example": "Test with all fields" }, "location": { "type": "object", "properties": { "id": { "type": "integer", "example": 3, "default": 0 }, "name": { "type": "string", "example": "East Pollyville" } } }, "notes": { "type": "string", "example": "This is a test" }, "supplier": { "type": "object", "properties": { "id": { "type": "integer", "example": 3, "default": 0 }, "name": { "type": "string", "example": "Effertz, Langworth and Prohaska" } } }, "cost": { "type": "string", "example": "100.00" }, "asset_maintenance_type": { "type": "string", "example": "Repair" }, "start_date": { "type": "object", "properties": { "datetime": { "type": "string", "example": "2018-03-06 00:00:00" }, "formatted": { "type": "string", "example": "Tue Mar 06, 2018 12:00AM" } } }, "asset_maintenance_time": { "type": "integer", "example": 20, "default": 0 }, "completion_date": { "type": "object", "properties": { "datetime": { "type": "string", "example": "2018-03-26 00:00:00" }, "formatted": { "type": "string", "example": "Mon Mar 26, 2018 12:00AM" } } }, "user_id": { "type": "object", "properties": { "id": { "type": "integer", "example": 2, "default": 0 }, "name": { "type": "string", "example": "Snipe E. Head" } } }, "created_at": { "type": "object", "properties": { "datetime": { "type": "string", "example": "2018-03-26 17:43:35" }, "formatted": { "type": "string", "example": "Mon Mar 26, 2018 5:43PM" } } }, "updated_at": { "type": "object", "properties": { "datetime": { "type": "string", "example": "2018-03-26 17:43:35" }, "formatted": { "type": "string", "example": "Mon Mar 26, 2018 5:43PM" } } }, "available_actions": { "type": "object", "properties": { "update": { "type": "boolean", "example": true, "default": true }, "delete": { "type": "boolean", "example": true, "default": true } } } } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "deprecated": false } } }, "x-readme": { "headers": [ { "key": "Authorization", "value": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIyIiwianRpIjoiN2I1OTg3ZGVlYzI0ZmUxNzZmM2M4Y2VmZmFkOWZhZTMwOGY5YTc5MWU5OTI1MjljMWRmMDFmMTFjYThjMWRmZWE5YTlhODdhMDcxOTA2Y2IiLCJpYXQiOjE3ODY2NjIwMzYuMzExNjY1LCJuYmYiOjE3ODY2NjIwMzYuMzExNjcsImV4cCI6MjQxNzgxNDAzNi4yOTc4MDcsInN1YiI6IjEiLCJzY29wZXMiOltdfQ.bsToXzAmDU_c0WfA36bjgIfP9reBXaDrV3vEz78fJ6mdvnGBBPfqRFD3nb2NL6Zr2X3EavWoFA2-Adn3L-0Ds7OFBfU9jdyu5vlaA-f6BHVBuJlGu2NO0SuYmlRG-2DqMQL8MHjM2NQ4k1HX5UV8ox9fzxXAe9nD7wmV0mgWtWAyq29XfiBZQcYWLKjam0LnvHbFnL29ikVazCK6_Kl9_7d0gkX32QdgbtgIFDmrngSHnAeO2wTvUvf-rz8HsV0cv_9SALuLPNSUXiKjC2amSsgzU05a0xFmMYu3mSmfgH2PDC2qAsByjOlU5yQDv2hTEBEle0c2N2-z1mL-udi49a1FreedSX0Vxm04RTFTO4UwZUO4TGsLu47JheVPuMUN5V4FUCpXPX6qoyiBrGHPWx6cfjYzEK0joJeNi9Q5LwMjZxmJ_1K2P13lTcw67fJEHQeBoiYles4TJXzgmKpYJtGRMdcdiLj8zFiDZYnq31imndZTjfIT5oTY5owEfKRCcfxoDjFMi7mrr0zpi1Tx9bGDUQLD50aoa3M1zqSQvOqi6StvWE-vDGYbRE3oNRIOtL5xQslLMLsvEK4etz_CsYW0WJ-tu_rKs7muU5yM0gIW2pCFiMbNGzJp37uFrxTD5LGn3b-r0gNhMWLYKGzYRIeyRWir2vymf2I0RX5wL5s" } ], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```