Developers | Maintainly                   Build on Maintainly
===================

Maintainly has a REST API covering the whole maintenance workflow: work orders, assets, materials, inventory, checklists, timesheets and more. Use it to sync Maintainly with your ERP, push readings from your sensors, or build the integration your team actually needs.

Everything is JSON over HTTPS, authenticated with a bearer token you generate yourself. The reference is public and always generated from the running service, and the OpenAPI specification is available for your tooling and coding agents.

 [ Read the API reference ](https://maintainly.com/developers/api) [ Get an API token ](https://app.maintainly.com/settings/tokens) 

 [   

Authentication
--------------

Generate a personal access token and send it as a bearer token. Covers the organization API key and the sandbox test organization.

 ](https://maintainly.com/developers/api#description/authentication) [      

Pagination
----------

List endpoints return links and meta objects alongside the data. Control paging with page and per\_page, up to 100 rows per request.

 ](https://maintainly.com/developers/api#description/pagination) [     

Errors
------

Every failure is JSON with a message, and validation failures add a per-field errors object.

 ](https://maintainly.com/developers/api#description/errors) [    

Rate limiting
-------------

Each token gets 100 requests per minute, with Retry-After and X-RateLimit headers so you can back off precisely.

 ](https://maintainly.com/developers/api#description/rate-limiting) [     

API reference
-------------

Every endpoint, its parameters, request body, response fields and a copyable cURL example.

 ](https://maintainly.com/developers/api) [    

OpenAPI specification
---------------------

The machine-readable document behind these docs. Point your client generator or coding agent straight at it.

 ](https://app.maintainly.com/openapi.json)