ACaccessowl
applications

Get an application by ID

Changed on

Returns a single application, including its owner, admins, and integration details.

get/api/v1/applications/{id}

Request

  • Base URL
    https://app.accessowl.io
  • URL
    https://app.accessowl.io/api/v1/applications/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Application ID

Response

Application

admin_user_idsstring[]

User IDs of the application's admins

auth_method'google' | 'microsoft' | 'okta' | 'sso_provider' | 'credentials' | 'other' nullable

Authentication method used to sign in

data_locationstring nullable

Where the vendor stores data

descriptionstring nullable

Description

idstring uuid required

Application ID

inserted_atstring date-time

Creation timestamp

last_vendor_review_atstring date nullable

Date of the last vendor security review

mfa_activatedboolean nullable

Whether MFA is activated for this application

notesstring nullable

Internal notes

owner_user_idstring uuid nullable

Owner user ID

permanent_access_allowedboolean

Whether the application allows permanent (non-expiring) access

processed_data_typesstring[]

Types of data this application processes

provisioning_type'application_admin' | 'automatic'

Provisioning type

risk_level'low' | 'medium' | 'high' nullable

Risk level assessment

status'ignored' | 'discovered' | 'approved' | 'requestable' required

Application status

time_based_access_durationsstring[]

Configured time-based access durations as ISO 8601 durations (e.g. "PT1H", "P7D"); empty when the app offers only permanent access

titlestring required

Application title

updated_atstring date-time

Last update timestamp

urlstring nullable

Application URL

user_countinteger nullable

Number of users with access

user_setup_urlstring nullable

URL where existing users are shown and new users are invited

vendor_certificatesstring[]

Security/compliance certifications held by the vendor

Example response

{
  "admin_user_ids": [
    "7488a646-e31f-11e4-aace-600308960665"
  ],
  "auth_method": "okta",
  "contract": {
    "annual_costs": "12000.00",
    "currency": "EUR",
    "end_date": "2026-12-31",
    "interval": "annually",
    "renewal_date": "2026-12-31",
    "start_date": "2025-01-01"
  },
  "data_location": "EU",
  "description": "Team communication platform",
  "id": "7488a646-e31f-11e4-aace-600308960662",
  "inserted_at": "2023-01-01T00:00:00Z",
  "last_vendor_review_at": "2026-01-15",
  "mfa_activated": true,
  "notes": "Reviewed in Q4",
  "owner_user_id": "7488a646-e31f-11e4-aace-600308960663",
  "permanent_access_allowed": true,
  "processed_data_types": [
    "customer_data"
  ],
  "provisioning_type": "automatic",
  "risk_level": "medium",
  "status": "requestable",
  "tags": [
    {
      "id": "7488a646-e31f-11e4-aace-600308960666",
      "title": "Communication"
    }
  ],
  "time_based_access_durations": [
    "PT1H",
    "P7D"
  ],
  "title": "Slack",
  "updated_at": "2023-01-01T00:00:00Z",
  "url": "https://slack.com",
  "user_count": 150,
  "user_setup_url": "https://slack.com/get-started",
  "vendor_certificates": [
    "soc2_t2",
    "iso_27001"
  ]
}

Changes

  • 5a1f071e40d8Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

  • 209e132db90bRevision changes
    • info

      added the optional property to the response with the status