Download OpenAPI specification:
Welcome to the Click Maint API! The API allows you to programmatically work with your Click Maint data — including Assets, Locations, Parts, Work Orders, and more. Use it to integrate Click Maint with your internal tools, automate workflows, or synchronize data with external systems.
For support, contact support@clickmaint.com
You will use this key to authenticate API requests.
All API requests require authentication using an API key.
Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Most API requests also require an Entity ID, which identifies the entity (location/business unit) that the request applies to. The Entity ID is specified in the X-Entity-Id header.
To get the Entity ID, you must first make a call to the GET /entities API endpoint.
X-Entity-Id: YOUR_ENTITY_ID
API requests are limited to:
Rate limit information is included in response headers:
X-RateLimit-Limit: Maximum requests allowedX-RateLimit-Remaining: Requests remaining in current windowX-RateLimit-Reset: Unix timestamp when the limit resetsretry-after: Amount of seconds to wait until limit resetsOnce you have your API Key and Entity ID, you can make your first request. Replace the .com with .ca if your account is in our Canadian region.
curl -X GET "https://app.clickmaint.com/api/v1/assets" -H "Authorization: Bearer <your-api-key>" -H "X-Entity-Id: <your-entity-id>" -H "Accept: application/json"
A successful response confirms your API Key and Entity ID are configured correctly.
| X-Entity-Id required | integer Entity ID |
Asset to create
required | object |
{- "asset": {
- "name": "Air Purifier",
- "asset_code": "AST-001",
- "description": "Machine used to purify the air in a shop by removing particles, allergens, and contaminants",
- "model": "Dyson Pure Cool Link Tower",
- "manufacturer": "Dyson",
- "serial_number": "H8tG5nWp",
- "purchase_date": "2023-08-24",
- "warranty_exp_date": "2026-08-24",
- "warranty_expiration_notification": 30,
- "life_expectancy": 36,
- "purchase_cost": 549.99,
- "replacement_cost": 599.99,
- "salvage_value": 150,
- "location_id": 12,
- "parent_id": 44,
- "asset_types_ids": [
- 4
], - "technicians_ids": [
- 3
], - "parts_ids": [
- 144,
- 145
], - "vendors_ids": [
- 32
], - "qr_code_attributes": {
- "value": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "generate_qr_code": true
},
}
}{- "status": "success",
- "data": {
- "id": 102,
- "name": "Air Purifier",
- "description": "Machine used to purify the air in a shop by removing particles, allergens, and contaminants",
- "model": "Dyson Pure Cool Link Tower",
- "manufacturer": "Dyson",
- "serial_number": "H8tG5nWp",
- "warranty_expiration_notification": 30,
- "life_expectancy": 36,
- "root_id": 44,
- "asset_code": "AHU-BLD1-01-001",
- "status": "online",
- "purchase_cost": 549.99,
- "replacement_cost": 599.99,
- "salvage_value": 150,
- "parent": {
- "id": 44,
- "name": "Air Conditioner"
}, - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "asset_types": [
- {
- "id": 4,
- "name": "HVAC"
}
], - "parts": [
- {
- "id": 144,
- "name": "Part A"
}, - {
- "id": 145,
- "name": "Part B"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "has_children": false,
- "purchase_date": "2023-08-24",
- "warranty_exp_date": "2026-08-24",
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[name_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 102,
- "name": "Air Purifier",
- "description": "Machine used to purify the air in a shop by removing particles, allergens, and contaminants",
- "model": "Dyson Pure Cool Link Tower",
- "manufacturer": "Dyson",
- "serial_number": "H8tG5nWp",
- "warranty_expiration_notification": 30,
- "life_expectancy": 36,
- "asset_code": "AHU-BLD1-01-001",
- "status": "online",
- "purchase_cost": 549.99,
- "replacement_cost": 599.99,
- "salvage_value": 150,
- "parent": {
- "id": 44,
- "name": "Air Conditioner"
}, - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "asset_types": [
- {
- "id": 4,
- "name": "HVAC"
}
], - "parts": [
- {
- "id": 144,
- "name": "Part A"
}, - {
- "id": 145,
- "name": "Part B"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration"
}
], - "purchase_date": "2023-08-24",
- "warranty_exp_date": "2026-08-24",
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "image": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "name_cont": "Building A"
}
}
}| id required | integer Asset ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 102,
- "name": "Air Purifier",
- "description": "Machine used to purify the air in a shop by removing particles, allergens, and contaminants",
- "model": "Dyson Pure Cool Link Tower",
- "manufacturer": "Dyson",
- "serial_number": "H8tG5nWp",
- "warranty_expiration_notification": 30,
- "life_expectancy": 36,
- "root_id": 44,
- "asset_code": "AHU-BLD1-01-001",
- "status": "online",
- "purchase_cost": 549.99,
- "replacement_cost": 599.99,
- "salvage_value": 150,
- "parent": {
- "id": 44,
- "name": "Air Conditioner"
}, - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "asset_types": [
- {
- "id": 4,
- "name": "HVAC"
}
], - "parts": [
- {
- "id": 144,
- "name": "Part A"
}, - {
- "id": 145,
- "name": "Part B"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "has_children": false,
- "purchase_date": "2023-08-24",
- "warranty_exp_date": "2026-08-24",
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Asset ID |
| X-Entity-Id required | integer Entity ID |
Fields to update on Asset
required | object |
{- "asset": {
- "name": "Air Purifier",
- "asset_code": "AST-001",
- "description": "Machine used to purify the air in a shop by removing particles, allergens, and contaminants",
- "model": "Dyson Pure Cool Link Tower",
- "manufacturer": "Dyson",
- "serial_number": "H8tG5nWp",
- "purchase_date": "2023-08-24",
- "warranty_exp_date": "2026-08-24",
- "warranty_expiration_notification": 30,
- "life_expectancy": 36,
- "purchase_cost": 549.99,
- "replacement_cost": 599.99,
- "salvage_value": 150,
- "location_id": 12,
- "parent_id": 44,
- "asset_types_ids": [
- 4
], - "technicians_ids": [
- 3
], - "parts_ids": [
- 144,
- 145
], - "vendors_ids": [
- 32
], - "qr_code_attributes": {
- "value": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "generate_qr_code": true,
- "_destroy_qr_code": true
},
}
}{- "status": "success",
- "data": {
- "id": 102,
- "name": "Air Purifier",
- "description": "Machine used to purify the air in a shop by removing particles, allergens, and contaminants",
- "model": "Dyson Pure Cool Link Tower",
- "manufacturer": "Dyson",
- "serial_number": "H8tG5nWp",
- "warranty_expiration_notification": 30,
- "life_expectancy": 36,
- "root_id": 44,
- "asset_code": "AHU-BLD1-01-001",
- "status": "online",
- "purchase_cost": 549.99,
- "replacement_cost": 599.99,
- "salvage_value": 150,
- "parent": {
- "id": 44,
- "name": "Air Conditioner"
}, - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "asset_types": [
- {
- "id": 4,
- "name": "HVAC"
}
], - "parts": [
- {
- "id": 144,
- "name": "Part A"
}, - {
- "id": 145,
- "name": "Part B"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "has_children": false,
- "purchase_date": "2023-08-24",
- "warranty_exp_date": "2026-08-24",
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| X-Entity-Id required | integer Entity ID |
required | Array of objects [ 1 .. 100 ] items Operations to be run sequentially. |
| sequential required | boolean Value: true Must be set to |
{- "ops": [
- {
- "method": "GET",
- "url": "/api/v1/parts"
}, - {
- "method": "PATCH",
- "url": "/api/v1/parts/24/reconcile",
- "params": {
- "quantity": -2,
- "note": "2 units damaged during shipping"
}
}
], - "sequential": true
}{- "results": [
- {
- "status": 200,
- "body": { }
}, - {
- "status": 200,
- "body": { }
}
]
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[name_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
{- "status": "success",
- "data": [
- {
- "id": 2,
- "name": "Main Facility",
- "description": "Primary manufacturing and distribution facility",
- "address": "123 Example St",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00",
- "currency": "USD",
- "currency_name": "United States Dollar",
- "currency_symbol": "$",
- "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 15,
- "updated_by_id": 22
}
], - "meta": {
- "entity": {
- "id": null,
- "name": null,
- "currency": null,
- "currency_symbol": null,
- "datetime_format": null,
- "timezone": null
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "name_cont": "Building A"
}
}
}| X-Entity-Id required | integer Entity ID |
Location to create
required | object |
{- "location": {
- "name": "Main Conference Room",
- "description": "Large conference room with projector and whiteboard. Seats up to 12 people.",
- "address": "101-123 Example St",
- "parent_id": 55,
- "qr_code_attributes": {
- "value": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "generate_qr_code": true
}
}
}{- "status": "success",
- "data": {
- "id": 56,
- "name": "Main Conference Room",
- "description": "Large conference room with projector and whiteboard. Seats up to 12 people.",
- "address": "101-123 Example St",
- "parent": {
- "id": 55,
- "name": "Building A"
}, - "root_id": 55,
- "path": "Building A > Main Conference Room",
- "has_children": false,
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 15,
- "updated_by_id": 22
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[name_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 56,
- "name": "Main Conference Room",
- "description": "Large conference room with projector and whiteboard. Seats up to 12 people.",
- "address": "101-123 Example St",
- "parent": {
- "id": 55,
- "name": "Building A"
}, - "path": "Building A > Main Conference Room",
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "image": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z"
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "name_cont": "Building A"
}
}
}| id required | integer Location ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 56,
- "name": "Main Conference Room",
- "description": "Large conference room with projector and whiteboard. Seats up to 12 people.",
- "address": "101-123 Example St",
- "parent": {
- "id": 55,
- "name": "Building A"
}, - "root_id": 55,
- "path": "Building A > Main Conference Room",
- "has_children": false,
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 15,
- "updated_by_id": 22
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Location ID |
| X-Entity-Id required | integer Entity ID |
Fields to update on Location
required | object |
{- "location": {
- "name": "Main Conference Room",
- "description": "Large conference room with projector and whiteboard. Seats up to 12 people.",
- "address": "101-123 Example St",
- "parent_id": 55,
- "qr_code_attributes": {
- "value": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "generate_qr_code": true,
- "_destroy_qr_code": true
}
}
}{- "status": "success",
- "data": {
- "id": 56,
- "name": "Main Conference Room",
- "description": "Large conference room with projector and whiteboard. Seats up to 12 people.",
- "address": "101-123 Example St",
- "parent": {
- "id": 55,
- "name": "Building A"
}, - "root_id": 55,
- "path": "Building A > Main Conference Room",
- "has_children": false,
- "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 15,
- "updated_by_id": 22
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| X-Entity-Id required | integer Entity ID |
Part to create
required | object |
{- "part": {
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "part_type_id": 3,
- "storeroom_id": 1,
- "measurement_unit_id": 2,
- "assets_ids": [
- 12
], - "vendor_parts_attributes": [
- {
- "vendor_id": 32,
- "vendor_part_number": "ABC-12345",
- "is_preferred": true
}
], - "qr_code_attributes": {
- "value": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "generate_qr_code": true
},
}
}{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[name_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "available": 5,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item"
}, - "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "ABC Corp."
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "image": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "name_cont": "Building A"
}
}
}| id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
Fields to update on Part
required | object |
{- "part": {
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "min_qty": 5,
- "desired_qty": 8,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "part_type_id": 3,
- "storeroom_id": 1,
- "measurement_unit_id": 2,
- "assets_ids": [
- 12
], - "vendor_parts_attributes": [
- {
- "vendor_id": 32,
- "vendor_part_number": "ABC-12345",
- "is_preferred": true,
- "_destroy": true
}
], - "qr_code_attributes": {
- "value": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "generate_qr_code": true,
- "_destroy_qr_code": true
},
}
}{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
| quantity required | number <decimal> decimal places <= 3 |
| cost required | number <decimal> decimal places <= 2 >= 0 Unit cost of restocked items. The Part's |
| note | string |
{- "quantity": 4,
- "cost": 26.15,
- "note": "Purchase order PO-12345 received"
}{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
| quantity required | number <decimal> decimal places <= 3 Positive or negative adjustment amount. The resulting |
| note required | string |
{- "quantity": -2,
- "note": "2 units damaged during shipping"
}{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
| cost required | number decimal places <= 2 >= 0 Sets the new |
| note | string |
{- "cost": 225.5,
- "note": "Cost updated per invoice INV-9847"
}{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
| cost required | number decimal places <= 2 >= 0 Sets the new |
| note | string |
{- "cost": 207.35,
- "note": "Adjusting after supplier rebate credit"
}{- "status": "success",
- "data": {
- "id": 72,
- "name": "Air Filter",
- "description": "Fiberglass panel filter",
- "is_non_stock": false,
- "number": "FL_A",
- "area": "Filters bin",
- "lead_time": 7,
- "on_hand_qty": 6,
- "min_qty": 5,
- "desired_qty": 8,
- "unit_cost": 26.15,
- "avg_unit_cost": 26.15,
- "part_type": {
- "id": 3,
- "name": "Filters"
}, - "storeroom": {
- "id": 1,
- "name": "Main Warehouse"
}, - "measurement_unit": {
- "id": 2,
- "name": "Item",
- "short_name": "itm"
}, - "available": 5,
- "reserved": 1,
- "assets": [
- {
- "id": 51,
- "name": "Air Purifier 1"
}, - {
- "id": 52,
- "name": "Air Purifier 2"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "is_preferred": true,
- "vendor_part_number": "ABC-12345",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "qr_code": "guVT5ngMeZ9xPBIk8db4dCGXVU",
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Part ID |
| search | string |
| sort | string Default: "updated_at desc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[note_cont]=invoice Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 102,
- "note": "Purchase order PO-12345 received",
- "type": "restock",
- "work_order_id": null,
- "cost": 26.15,
- "total_cost": 52.3,
- "quantity": 2,
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "note_cont": "invoice"
}, - "total_used": 8.5
}
}| id required | integer Part ID |
| transaction_id required | integer Part Transaction ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 102,
- "note": "Purchase order PO-12345 received",
- "type": "restock",
- "work_order_id": null,
- "cost": 26.15,
- "total_cost": 52.3,
- "quantity": 2,
- "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "created_at desc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[title_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 22,
- "status": "planned",
- "type": "persistent",
- "start_date": "2025-02-18T12:00:00.000Z",
- "time_to_complete": 4,
- "next_order_date": "2026-07-18T12:00:00.000Z",
- "next_due_date": "2026-07-18T16:00:00.000Z",
- "repeat_frequency": "month",
- "repeat_occurrence": "custom",
- "on_week_days": [
- 1
], - "in_months": [
- 2,
- 7
], - "on_month_day": 18,
- "template_work_order": {
- "id": 1126,
- "title": "HVAC filter replacement",
- "description": "Replace air filters on all HVAC units, checking for proper airflow, belt condition, and coil cleanliness.",
- "priority": "high",
- "asset": {
- "id": 45,
- "name": "Freezer",
- "status": "online"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "account_codes": [
- {
- "id": 1,
- "name": "Emergency Repairs"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "ABC Corp."
}
], - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "has_uncompleted_wo": false,
- "progression": {
- "percentage": 55,
- "id": 756,
- "status": null
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "title_cont": "Building A"
}
}
}| id required | integer PM ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 22,
- "status": "planned",
- "type": "persistent",
- "start_date": "2025-02-18T12:00:00.000Z",
- "time_to_complete": 4,
- "next_order_date": "2026-07-18T12:00:00.000Z",
- "next_due_date": "2026-07-18T16:00:00.000Z",
- "repeat_frequency": "month",
- "repeat_occurrence": "custom",
- "on_week_days": [
- 1
], - "in_months": [
- 2,
- 7
], - "on_month_day": 18,
- "procedure_templates": [
- {
- "id": 10,
- "name": "Building Maintenance Audit"
}
], - "template_work_order": {
- "id": 1126,
- "title": "HVAC filter replacement",
- "description": "Replace air filters on all HVAC units, checking for proper airflow, belt condition, and coil cleanliness.",
- "priority": "high",
- "checklist": [
- {
- "text": "Inspect defrost drain for blockages",
- "order": 1,
- "checked": false
}, - {
- "text": "Clear drain line with warm water",
- "order": 2,
- "checked": false
}
], - "asset": {
- "id": 45,
- "name": "Freezer",
- "status": "online"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "account_codes": [
- {
- "id": 1,
- "name": "Emergency Repairs"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "part_assignments": [
- {
- "part_id": 52,
- "part_name": "Air Filter",
- "quantity": 2,
- "unit_name": "Item",
- "unit_short_name": "itm",
- "type": "usage",
- "total_cost": 52.3
}
], - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "has_work_orders": true,
- "has_uncompleted_wo": false,
- "progression": {
- "percentage": 55,
- "id": 756,
- "status": null
}, - "last_active_work_order_id": 756,
- "last_active_work_order_title": "HVAC filter replacement",
- "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 1,
- "updated_by_id": 2
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[name_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 10,
- "name": "Building Maintenance Audit",
- "description": "Inspection to identify maintenance needs and safety issues",
- "assignment_count": {
- "work_orders": 14,
- "pm_schedules": 2
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "title_cont": "Building A"
}
}
}| id required | integer Procedure ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 10,
- "name": "Building Maintenance Audit",
- "description": "Inspection to identify maintenance needs and safety issues",
- "items": [
- {
- "id": 119,
- "name": "Inspection Type",
- "index": 1,
- "item_type": "multiple_choice",
- "options": {
- "choices": [
- "Routine",
- "Preventative",
- "Emergency",
- "Post-Repair"
]
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
]
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 1,
- "updated_by_id": 1
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| X-Entity-Id required | integer Entity ID |
Request to create
required | object |
{- "work_order_request": {
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "status": "on_hold",
- "notify": true,
- "priority": "high",
- "location_id": 122,
- "asset_id": 45,
- "categories_ids": [
- 5,
- 10
], - "technicians_ids": [
- 3
], - "vendors_ids": [
- 32
], - "due_date": "2025-07-17T12:00:00Z"
}
}{- "status": "success",
- "data": {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "status": "on_hold",
- "notify": true,
- "priority": "high",
- "work_order_id": 864,
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "asset": {
- "id": 45,
- "name": "Freezer"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "request_portal": {
- "id": 3,
- "uuid": "72f5525c-dca6-422c-bbd3-6ef4e965a332",
- "title": "Main Request Portal"
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "phone_number": "1-493-480-9163",
- "email": "bob_smith@example.com",
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "created_at desc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[title_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "status": "on_hold",
- "priority": "high",
- "work_order_id": 864,
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "asset": {
- "id": 45,
- "name": "Freezer"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "ABC Corp."
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "comments_count": 2,
- "request_portal": {
- "id": 3,
- "uuid": "72f5525c-dca6-422c-bbd3-6ef4e965a332",
- "title": "Main Request Portal"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "title_cont": "Building A"
}
}
}| id required | integer Request ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "status": "on_hold",
- "notify": true,
- "priority": "high",
- "work_order_id": 864,
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "asset": {
- "id": 45,
- "name": "Freezer"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "request_portal": {
- "id": 3,
- "uuid": "72f5525c-dca6-422c-bbd3-6ef4e965a332",
- "title": "Main Request Portal"
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "phone_number": "1-493-480-9163",
- "email": "bob_smith@example.com",
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Request ID |
| X-Entity-Id required | integer Entity ID |
Fields to update on Request
required | object |
{- "work_order_request": {
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "status": "on_hold",
- "notify": true,
- "priority": "high",
- "location_id": 122,
- "asset_id": 45,
- "categories_ids": [
- 5,
- 10
], - "technicians_ids": [
- 3
], - "vendors_ids": [
- 32
], - "due_date": "2025-07-17T12:00:00Z"
}
}{- "status": "success",
- "data": {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "status": "on_hold",
- "notify": true,
- "priority": "high",
- "work_order_id": 864,
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "asset": {
- "id": 45,
- "name": "Freezer"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "request_portal": {
- "id": 3,
- "uuid": "72f5525c-dca6-422c-bbd3-6ef4e965a332",
- "title": "Main Request Portal"
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "phone_number": "1-493-480-9163",
- "email": "bob_smith@example.com",
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[can_be_assigned_to_wo_eq]=true Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "full_name": "John Doe",
- "language": "en",
- "email": "john-doe@acme-corporation.com",
- "unconfirmed_email": "jdoe@acme-corporation.com",
- "phone_number": "+12222222222",
- "job_title": "Maintenance Manager",
- "status": "active",
- "can_be_assigned_to_wo": true,
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg",
- "regular_rate": 41,
- "overtime_rate1": 61.5,
- "overtime_rate2": 82,
- "permissions": [
- {
- "entity": "Main Facility",
- "entity_id": 1,
- "role": "admin",
- "user_role_id": 2
}
], - "activity": {
- "last_login": "2026-02-23T21:38:35Z",
- "login_count": 47
}, - "tenant": "acme-corporation",
- "invitation_details": {
- "sent_at": "2025-12-02T22:21:48Z",
- "due_at": "2025-12-07T22:21:48Z",
- "accepted_at": "2025-12-03T17:15:55Z"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 1,
- "updated_by_id": 2
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "John Doe",
- "filter": {
- "can_be_assigned_to_wo": "true"
}
}
}| id required | integer User ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "full_name": "John Doe",
- "language": "en",
- "email": "john-doe@acme-corporation.com",
- "unconfirmed_email": "jdoe@acme-corporation.com",
- "phone_number": "+12222222222",
- "job_title": "Maintenance Manager",
- "status": "active",
- "can_be_assigned_to_wo": true,
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg",
- "regular_rate": 41,
- "overtime_rate1": 61.5,
- "overtime_rate2": 82,
- "permissions": [
- {
- "entity": "Main Facility",
- "entity_id": 1,
- "role": "admin",
- "user_role_id": 2
}
], - "activity": {
- "last_login": "2026-02-23T21:38:35Z",
- "login_count": 47
}, - "tenant": "acme-corporation",
- "invitation_details": {
- "sent_at": "2025-12-02T22:21:48Z",
- "due_at": "2025-12-07T22:21:48Z",
- "accepted_at": "2025-12-03T17:15:55Z"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 1,
- "updated_by_id": 2
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "name asc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[assign_to_work_orders_eq]=true Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "description": "Commercial HVAC and refrigeration installation, maintenance, and repair services",
- "is_active": true,
- "assign_to_work_orders": true,
- "parts_supplier": true,
- "tax_id": "12-3456789",
- "address": "123 Example St",
- "rating": 5,
- "hourly_rate": 32.5,
- "locations": [
- {
- "id": 20,
- "name": "Building A"
}
], - "vendor_contacts": [
- {
- "id": 24,
- "name": "Robert Smith",
- "role": "HVAC Technician",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989",
- "is_primary": true
}
], - "categories": [
- {
- "id": 5,
- "name": "HVAC"
}, - {
- "id": 10,
- "name": "Refrigeration"
}
], - "assets": [
- {
- "id": 102,
- "name": "Air Purifier"
}
], - "parts": [
- {
- "id": 72,
- "name": "Air Filter"
}
], - "image": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "John Doe",
- "filter": {
- "assign_to_work_orders": "true"
}
}
}| id required | integer Vendor ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "description": "Commercial HVAC and refrigeration installation, maintenance, and repair services",
- "is_active": true,
- "assign_to_work_orders": true,
- "parts_supplier": true,
- "tax_id": "12-3456789",
- "address": "123 Example St",
- "rating": 5,
- "hourly_rate": 32.5,
- "locations": [
- {
- "id": 20,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}
], - "vendor_contacts": [
- {
- "id": 24,
- "name": "Robert Smith",
- "role": "HVAC Technician",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989",
- "is_primary": true
}
], - "categories": [
- {
- "id": 5,
- "name": "HVAC"
}, - {
- "id": 10,
- "name": "Refrigeration"
}
], - "assets": [
- {
- "id": 102,
- "name": "Air Purifier"
}
], - "parts": [
- {
- "id": 72,
- "name": "Air Filter"
}
], - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by_id": 1,
- "updated_by_id": 2
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| X-Entity-Id required | integer Entity ID |
Work order to create
required | object |
{- "work_order": {
- "title": "Fix water leakage in Freezer",
- "type": "reactive",
- "description": "Water leakage due to blocked defrost drain",
- "priority": "high",
- "work_order_request_id": 864,
- "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "location_id": 122,
- "asset_id": 45,
- "status_id": 5,
- "categories_ids": [
- 10
], - "account_codes_ids": [
- 1
], - "procedure_template_ids": [
- 10
], - "technicians_ids": [
- 3
], - "vendors_ids": [
- 32
], - "notify_vendors_on_create": "yes",
- "notify_vendors_on_update": "yes",
- "checklist": [
- {
- "text": "Inspect defrost drain for blockages",
- "order": 1,
- "checked": false
}, - {
- "text": "Clear drain line with warm water",
- "order": 2,
- "checked": false
}
]
}
}{- "status": "success",
- "data": {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "priority": "high",
- "type": "reactive",
- "pm_schedule_id": 78,
- "procedures": [
- {
- "id": 119,
- "name": "Refrigeration Procedure",
- "procedure_template_id": 10,
- "completed_at": "2025-07-15T09:30:00Z"
}
], - "checklist": [
- {
- "text": "Inspect defrost drain for blockages",
- "order": 1,
- "checked": false
}, - {
- "text": "Clear drain line with warm water",
- "order": 2,
- "checked": false
}
], - "status": {
- "id": 5,
- "name": "completed",
- "is_custom": false
}, - "work_order_request": {
- "id": 45,
- "title": "Fix water leakage in Freezer",
- "created_at": "2025-07-17T19:19:20Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "phone_number": "1-493-480-9163",
- "email": "bob_smith@example.com",
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
}, - "asset": {
- "id": 45,
- "name": "Freezer",
- "status": "online"
}, - "downtime_tracking": {
- "id": 22,
- "started_at": "2025-07-17T19:19:20Z",
- "ended_at": "2025-07-19T14:20:25Z",
- "status": "online"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "account_codes": [
- {
- "id": 1,
- "name": "Emergency Repairs"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "notify_vendors_on_create": "yes",
- "notify_vendors_on_update": "yes",
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "part_assignments": [
- {
- "part_id": 52,
- "part_name": "Air Filter",
- "quantity": 2,
- "unit_name": "Item",
- "unit_short_name": "itm",
- "type": "usage",
- "total_cost": 52.3
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "total_costs": {
- "labor": 146,
- "other": 38,
- "parts": 28.15,
- "total": 212.15
}, - "active_timer_current_user": {
- "created_by_id": 3,
- "started_at": "2025-07-17T19:19:20Z"
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| search | string |
| sort | string Default: "created_at desc" Example: sort=created_at desc Sort by field ascending or descending |
object Example: filter[title_cont]=building Filter using filter[field_matcher] syntax | |
| page | integer Default: 1 Page number |
| per_page | integer Default: 50 Items per page |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": [
- {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "priority": "high",
- "type": "reactive",
- "work_order_request_id": 864,
- "pm_schedule_id": 78,
- "status": {
- "id": 5,
- "name": "completed",
- "is_custom": false
}, - "comments_count": 2,
- "asset": {
- "id": 45,
- "name": "Freezer",
- "status": "online"
}, - "downtime_tracking": {
- "id": 22,
- "started_at": "2025-07-17T19:19:20Z",
- "ended_at": "2025-07-19T14:20:25Z",
- "status": "online"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "account_codes": [
- {
- "id": 1,
- "name": "Emergency Repairs"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "ABC Corp."
}
], - "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "active_timer_current_user": {
- "created_by_id": 3,
- "started_at": "2025-07-17T19:19:20Z"
}, - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}
], - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}, - "pagination": {
- "total": 50,
- "page": 1,
- "per_page": 25,
- "total_pages": 2
}, - "sort": [
- "created_at desc"
], - "search": "Building A",
- "filter": {
- "title_cont": "Building A"
}
}
}| id required | integer Work Order ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "success",
- "data": {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "priority": "high",
- "type": "reactive",
- "pm_schedule_id": 78,
- "procedures": [
- {
- "id": 119,
- "name": "Refrigeration Procedure",
- "procedure_template_id": 10,
- "completed_at": "2025-07-15T09:30:00Z"
}
], - "checklist": [
- {
- "text": "Inspect defrost drain for blockages",
- "order": 1,
- "checked": false
}, - {
- "text": "Clear drain line with warm water",
- "order": 2,
- "checked": false
}
], - "status": {
- "id": 5,
- "name": "completed",
- "is_custom": false
}, - "work_order_request": {
- "id": 45,
- "title": "Fix water leakage in Freezer",
- "created_at": "2025-07-17T19:19:20Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "phone_number": "1-493-480-9163",
- "email": "bob_smith@example.com",
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
}, - "asset": {
- "id": 45,
- "name": "Freezer",
- "status": "online"
}, - "downtime_tracking": {
- "id": 22,
- "started_at": "2025-07-17T19:19:20Z",
- "ended_at": "2025-07-19T14:20:25Z",
- "status": "online"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "account_codes": [
- {
- "id": 1,
- "name": "Emergency Repairs"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "notify_vendors_on_create": "yes",
- "notify_vendors_on_update": "yes",
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "part_assignments": [
- {
- "part_id": 52,
- "part_name": "Air Filter",
- "quantity": 2,
- "unit_name": "Item",
- "unit_short_name": "itm",
- "type": "usage",
- "total_cost": 52.3
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "total_costs": {
- "labor": 146,
- "other": 38,
- "parts": 28.15,
- "total": 212.15
}, - "active_timer_current_user": {
- "created_by_id": 3,
- "started_at": "2025-07-17T19:19:20Z"
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Work Order ID |
| X-Entity-Id required | integer Entity ID |
Fields to update on Work Order
required | object |
{- "work_order": {
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "priority": "none",
- "due_date": "2019-08-24T14:15:22Z",
- "completed_at": "2019-08-24T14:15:22Z",
- "location_id": 122,
- "asset_id": 45,
- "status_id": 1,
- "categories_ids": [
- 10
], - "account_codes_ids": [
- 1
], - "procedure_template_ids": [
- 10
], - "technicians_ids": [
- 3
], - "vendors_ids": [
- 32
], - "notify_vendors_on_update": "yes",
- "checklist": [
- {
- "text": "Inspect defrost drain for blockages",
- "order": 1,
- "checked": false
}, - {
- "text": "Clear drain line with warm water",
- "order": 2,
- "checked": false
}
]
}
}{- "status": "success",
- "data": {
- "id": 1126,
- "title": "Fix water leakage in Freezer",
- "description": "Water leakage due to blocked defrost drain",
- "priority": "high",
- "type": "reactive",
- "pm_schedule_id": 78,
- "procedures": [
- {
- "id": 119,
- "name": "Refrigeration Procedure",
- "procedure_template_id": 10,
- "completed_at": "2025-07-15T09:30:00Z"
}
], - "checklist": [
- {
- "text": "Inspect defrost drain for blockages",
- "order": 1,
- "checked": false
}, - {
- "text": "Clear drain line with warm water",
- "order": 2,
- "checked": false
}
], - "status": {
- "id": 5,
- "name": "completed",
- "is_custom": false
}, - "work_order_request": {
- "id": 45,
- "title": "Fix water leakage in Freezer",
- "created_at": "2025-07-17T19:19:20Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe",
- "phone_number": "1-493-480-9163",
- "email": "bob_smith@example.com",
- "auth_type": "api_key",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
}, - "asset": {
- "id": 45,
- "name": "Freezer",
- "status": "online"
}, - "downtime_tracking": {
- "id": 22,
- "started_at": "2025-07-17T19:19:20Z",
- "ended_at": "2025-07-19T14:20:25Z",
- "status": "online"
}, - "categories": [
- {
- "id": 10,
- "name": "Refrigeration"
}
], - "account_codes": [
- {
- "id": 1,
- "name": "Emergency Repairs"
}
], - "technicians": [
- {
- "id": 3,
- "name": "John",
- "surname": "Doe",
- "avatar": "/api/v1/store/attachments/image/1/upload/small-abc123def456.jpg"
}
], - "vendors": [
- {
- "id": 32,
- "name": "Summit HVAC & Refrigeration",
- "primary_contact": {
- "id": 24,
- "name": "Robert Smith",
- "email": "robert_smith@example.com",
- "phone": "1-493-480-9163",
- "extension": "989"
}
}
], - "notify_vendors_on_create": "yes",
- "notify_vendors_on_update": "yes",
- "location": {
- "id": 12,
- "name": "Building A",
- "path": "Building A > Main Conference Room"
}, - "part_assignments": [
- {
- "part_id": 52,
- "part_name": "Air Filter",
- "quantity": 2,
- "unit_name": "Item",
- "unit_short_name": "itm",
- "type": "usage",
- "total_cost": 52.3
}
], - "due_date": "2025-07-17T12:00:00Z",
- "completed_at": "2025-07-15T09:30:00Z",
- "total_costs": {
- "labor": 146,
- "other": 38,
- "parts": 28.15,
- "total": 212.15
}, - "active_timer_current_user": {
- "created_by_id": 3,
- "started_at": "2025-07-17T19:19:20Z"
}, - "images": [
- {
- "id": 5,
- "url": "/api/v1/store/attachments/image/5/upload/d9a6433a7e8acdfaa8dce1f339172449.jpg",
- "download_url": "../dictionary",
- "size": 2017802,
- "type": "image/jpeg",
- "name": "conference-room-photo.jpg",
- "attachment_urls": {
- "small": "/api/v1/store/attachments/image/5/upload/small-f3687c1c901ce528370aac370f888ed3.jpg",
- "medium": "/api/v1/store/attachments/image/5/upload/medium-f0dfda3ad1ea6b708d46adbf57d6bed1.jpg",
- "large": "/api/v1/store/attachments/image/5/upload/large-1b4dc08567e1df9f550b5c75a174f915.jpg"
}
}
], - "documents": [
- {
- "id": 6,
- "url": "/api/v1/store/attachments/document/6/upload/45bcc85b9513c2c4302b468c4694ae16.pdf",
- "download_url": "../dictionary",
- "size": 39777,
- "type": "application/pdf",
- "name": "asset-manual.pdf"
}
], - "created_at": "2025-07-17T19:19:20Z",
- "updated_at": "2025-09-24T14:20:25Z",
- "created_by": {
- "id": 1,
- "name": "John",
- "surname": "Doe"
}, - "updated_by": {
- "id": 2,
- "name": "Alice",
- "surname": "Johnson"
}
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Work Order ID |
| X-Entity-Id required | integer Entity ID |
| part_id required | integer |
| quantity required | number <decimal> decimal places <= 3 >= 0 Quantity to add. If this Part is already assigned, this will add to the existing quantity. |
{- "part_id": 52,
- "quantity": 2
}{- "status": "success",
- "data": {
- "part_id": 52,
- "part_name": "Air Filter",
- "quantity": 2,
- "unit_name": "Item",
- "unit_short_name": "itm",
- "type": "usage",
- "total_cost": 52.3
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Work Order ID |
| X-Entity-Id required | integer Entity ID |
| part_id required | integer |
| quantity required | number <decimal> decimal places <= 3 >= 0 New quantity for existing Part assignment |
{- "part_id": 52,
- "quantity": 2
}{- "status": "success",
- "data": {
- "part_id": 52,
- "part_name": "Air Filter",
- "quantity": 2,
- "unit_name": "Item",
- "unit_short_name": "itm",
- "type": "usage",
- "total_cost": 52.3
}, - "meta": {
- "entity": {
- "id": 1,
- "name": "Main Facility",
- "currency": "USD",
- "currency_symbol": "$",
- "datetime_format": "MM/DD/YYYY - 11:59 PM",
- "timezone": "Etc/UTC: +00:00"
}, - "customer": {
- "id": 84,
- "name": "Acme Corporation"
}
}
}| id required | integer Work Order ID |
| part_id required | integer Part ID |
| X-Entity-Id required | integer Entity ID |
{- "status": "error",
- "message": "Invalid API key"
}