The SOMA API gives operators, MROs and their IT teams secure, programmatic access to fleet, flight and maintenance data — so SOMA works hand in hand with your ERP, BI dashboards and in-house applications.
GET /api/v1/aircraft/[REGISTRATION] Authorization: Bearer [YOUR_TOKEN] 200 OK · application/json { "registration": "[REG]", "model": "[AIRCRAFT MODEL]", "totalHours": 12458.6, "totalCycles": 9873, "nextInspection": "[TASK / DUE DATE]" }
Illustrative example. Endpoints and fields per the official documentation.
SOMA already holds your single source of truth for airworthiness. The API lets that truth flow to the rest of your business — automatically, accurately and in real time.
Sync flight hours, cycles and work orders between SOMA and your other systems automatically, cutting manual errors and admin time.
Share purchasing, inventory and maintenance cost data with your ERP and accounting tools so finance and engineering work from the same numbers.
Feed Power BI, Looker Studio, Tableau or your data warehouse with live fleet and maintenance data for the reports leadership actually asks for.
Onboard new aircraft or import historical records at scale instead of entering them one by one — ideal for fleet growth and system transitions.
Create internal portals, line-station tools or customer-facing views on top of SOMA data, without waiting on a product roadmap.
Trigger workflows in your automation platform and give AI tools structured, reliable aviation data to work with.
The API exposes the records your teams already manage in SOMA, with the same rules and permissions that keep them accurate.
Ask about your use case →Aircraft, components, accumulated hours and cycles.
Flight sheets, block and flight times, fuel and crew.
Work orders, tasks, inspections and due items.
Parts, stock levels, rotables and purchase orders.
Certificates, licenses and expiration dates.
Share the systems and data flows you have in mind. Our team scopes the integration with you and confirms what the API covers.
Receive your organization’s credentials and full access to the interactive API reference, with request and response examples.
Your developers build at their own pace — or let SOMA’s engineering team build it for you through our custom development service.
Clear, documented endpoints your team can start with in minutes, plus a support team that understands both the code and the airworthiness rules behind the data.
curl -X POST "https://api.somasoftware.com/soma-api-public/api/auth/login" \ -H "Content-Type: application/json" \ -H "Authorization: Basic <BASE64_OF_YOUR_CREDENTIALS>" \ -d '{"username": "YOUR_ACCOUNT@YOUR_COMPANY.com", "password": "YOUR_PASSWORD"}'
import requests response = requests.post( "https://api.somasoftware.com/soma-api-public/api/auth/login", headers={ "Content-Type": "application/json", "Authorization": "Basic <BASE64_OF_YOUR_CREDENTIALS>", }, json={ "username": "YOUR_ACCOUNT@YOUR_COMPANY.com", "password": "YOUR_PASSWORD", }, ) print(response.json()) # includes the JWT for your next requests
const response = await fetch( "https://api.somasoftware.com/soma-api-public/api/auth/login", { method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Basic <BASE64_OF_YOUR_CREDENTIALS>", }, body: JSON.stringify({ username: "YOUR_ACCOUNT@YOUR_COMPANY.com", password: "YOUR_PASSWORD", }), } ); const data = await response.json(); // includes the JWT for your next requests
Use the returned JWT in the Authorization header of every following request.
The API is available to organizations with an active SOMA subscription that add API access to their plan. Access is granted per organization, so every integration only sees your own data.
Yes. API access is an additional subscription to your SOMA plan. Contact our team and we will prepare a proposal based on your integration needs.
It is a REST API served over HTTPS that exchanges data in JSON, so it works with virtually any programming language, ERP, BI tool or automation platform.
Yes. Once your organization is granted access, your team receives an interactive Swagger reference that lists every available endpoint with its parameters and example responses, so developers can explore and test calls directly from the browser.
Both. You can retrieve records and also create or update them — for example, loading flight hours from another system.
Authentication is based on JWT (JSON Web Tokens). Your integration logs in with your organization’s credentials, receives a token and sends it with every request. All traffic travels encrypted over HTTPS, and each integration only accesses the data of its own organization.
Yes. Through our Custom Aerospace Development service, SOMA’s engineers can design and build the integration with your ERP, BI or internal tools for you.
Yes. The standard API subscription includes up to 30,000 requests per month and 1,000 requests per day (a request is any GET, POST, PUT, PATCH or DELETE call). If your integration needs higher volumes, our team will quote an expansion for you.
