Information on OMS API
OMS uses APIs to pull data from the IHQ database and load the information into the application. The OMS APIs can be run in Postman to access the desired JSON data. There are many options in Postman so the following outlines what a user needs to do in order to get results when calling an OMS API.
For more information on using Postman refer to their website: Postman Support.
Overview
URL
Users should refer to the articles below for each OMS API as the parameters will vary for each one. It is important to format the URL correctly to ensure the request can be returned. The following articles will offer additional information regarding each API URL and the available parameters. All of these APIs are "GET" calls and return JSON data. All endpoints require an authorization header included in the request.
Base URL: https://ips-api-prod.salvationarmy.org/
New base URL as of 1/31/2022.
- OMS Active Officer API
- OMS Ad Hoc Report API
- OMS Appointment Data by Unit API
- OMS Appointments (Moves) API
- OMS Children API
- OMS Contact Info for Person API
- OMS Contact Info for Unit API
- OMS Officer Status API
- OMS Officer Taxes API
- OMS Person API
- OMS Personnel by Date API
- OMS Photos API
- OMS Retired Officers API
- OMS Separated Officer API
- OMS Spouse API
- OMS Testing API
Authorization
In order to call IPS APIs, an `access_token` is required to be sent in the `authorization` header with the request. In order to retrieve a token, a client application registration is required. To set up machine-to-machine access, follow the steps outlined in the document below.
Common error responses:
200 OK | Results were found that match the request and are included in the response body |
401 Unauthorized | The current account in the request header does not have access to the API |
403 Forbidden | The current account in the request header does not have access to the territory requested in the request URL |
404 Not Found | Returned if NO results were found that match the specified criteria |
500 Internal Server Error | One or more request string parameters are invalid or an error was encountered by the server while processing the request |