The aircalc NEXT external API is designed to integrate aircalc with CRM, ERP, and document systems.
It is used to retrieve information from aircalc about projects and configured units.
URL: https://{clientname}.aircalc.app/external/docs/static/index.html
Grant type for the authorisation is Client credentials.
Client id and client secret are shared through other channels upon contact.
200 requests per 10 minutes.
Released endpoints are version-controlled using the version number v1, v2 etc.
After a new version is released, the previous version is maintained for six months.
Endpoints at v0 are available but the interface is not yet finalized — changes may require adaptations in the calling application.
| Category | Endpoint | Parameter | Description |
|---|---|---|---|
| Bom | /ahu-bom-by-pos-no/v0/{posNo} |
posNo = Position number |
Get ahu BOM by pos number |
| Bom | /ahu-bom-by-external-ref/v0/{externalRef} |
externalRef = External reference |
Get ahu BOM by external reference |
| Bom | /ahu-bom-classic-by-pos-no/v0/{posNo} |
posNo = Position number |
Get classic style ahu BOM by pos number |
| Bom | /ahu-bom-classic-by-external-ref/v0/{externalRef} |
externalRef = External reference |
Get classic style ahu BOM by external reference |
| Pos | /pos-by-external-ref/v0/{externalRef} |
externalRef = External reference |
Get pos by external ref |
| Pos | /pos-by-no/v0/{posNo} |
posNo = Position number |
Get pos by no |
| Printout | /report/v0 |
Get report | |
| Production | /ahu-production-parts-xml-by-pos-no/v0/{posNo} |
posNo = Position number |
Get ahu production parts by pos no |
| Production | /ahu-production-parts-xml-by-external-ref/v0/{externalRef} |
externalRef = External reference |
Get ahu production parts by external reference |
| Project | /project-by-no/v0/{projectNo} |
projectNo = Project number |
Get project with position and ahu meta |
| Project | /project-by-external-ref/v0/{externalRef} |
externalRef = External reference |
Get project with position and ahu meta |
| Project | /pos-rows-aggregated/v0 |
Get row data from positions | |
| Project | /users-by-id/v0 |
Get user meta info by ids. | |
| Transport optimizer | /project-transport-optimizer-by-no/v0/{projectNo} |
projectNo = Project number |
Get transport optimizer for an entire project |
| Transport optimizer | /project-transport-optimizer-by-external-ref/v0/{externalRef} |
externalRef = External reference |
Get transport optimizer for an entire project |