get https://api.toriihq.com/v1.0/apps/
Returns a specific app.
This endpoint has two versions: 1.0 and 1.1. The default version is 1.0 from API keys created before Feb 1st 2025 and 1.1 for keys created after Feb 1st 2025. You can still specify the version via the "X-API-Version" header to override.
Example:
GET /apps/1?fields=id,name,myCustomField&state=discovered&myCustomField=trueThe above example returns app with id=1. 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 |
- Rate limit: 400 requests per minute