get https://api.toriihq.com/v1.0/apps
Returns a list of apps used in the organization.
This endpoint has two versions: 1.0 and 1.1. The default version is 1.0, specify the version via the "X-API-Version" header.
Filtering is available via the documented query parameters below and by custom application fields.
Example:
GET /apps?fields=id,name,myCustomField&state=discovered&myCustomField=trueThe above example returns a list of applications that are in
discovered state and myCustomField is true. Each application object will contain the id, name and myCustomField fields.Query params are different per version:
| Query param | Supported in version | Description | Default value |
|---|---|---|---|
| fields | v1.0 | List of fields to return for each application. Allowed fields: id, name, primaryOwner, appOwners, state, category, url, imageUrl, description, tags, users, score, isCustom, addedBy, creationTime, isHidden, lastUsageTime, sources, vendor and all fields from /apps/fields | id,name,primaryOwner |
| fields | v1.1 | List of fields to return for each application. Allowed fields: id, name, primaryOwner, appOwners, state, category, url, imageUrl, description, tags, users, score, isCustom, addedBy, creationTime, isHidden, lastUsageTime, sources, vendor, expenses, activeContractsTotalValue and all fields from /apps/fields | id,name,primaryOwner |
| q | v1.0, v1.1 | The query to search | (no value) |
| sort | v1.1 only | Sort order | (no value) |
| size | v1.1 only | Number of results to return (max: 1000) | 1000 |
| cursor | v1.1 only | cursor for pagination | (no value) |
- Rate limit: 200 requests per minute