Retrieve a CSV export of filtered applications

Okta Admin Management API

Applications

Retrieve a CSV export of filtered applications

Request

Early Access

okta.apps.read

Retrieves the filtered AppInstance list as text/csv streamed over Transfer-Encoding: chunked. Accepts the same typed filters as List all applications that match search filters. The CSV rows match the on-screen search result row-for-row.

Query

qstring, >= 2 characters

Case-insensitive substring match on app display name and instance label. Minimum 2 characters; leading/trailing whitespace is trimmed.

Example:q=salesforce

statusArray of strings

A comma-separated list of app statuses. Multiple values are combined using OR logic. Example: status=ACTIVE,INACTIVE.

Example:status=ACTIVE&status=INACTIVE

typesArray of strings

A comma-separated list of app types. Multiple values are combined using OR logic within the fixed type taxonomy. Example: types=SAML,OIDC,UNIVERSAL_LOGOUT.

Example:types=SAML&types=OIDC

labelsArray of strings

List of labels for the app-instance.

Example:labels=HR&labels=IT

GET

/api/v1/apps/export

curl -i -X GET \
  'https://subdomain.okta.com/api/v1/apps/export?q=salesforce&status=ACTIVE%2CINACTIVE&types=SAML%2COIDC&labels=HR%2CIT'

Responses

CSV stream

Headers

Content-Dispositionstring

Attachment filename in the form apps_<orgShortName>_<ISO8601>.csv.

Example:"attachment; filename=\"apps_acme_2026-06-25T10-00-00Z.csv\""

Transfer-Encodingstring

Always chunked; the CSV streams in ~100-row pages.

Example:"chunked"

Bodytext/csv

string

CSV with a header row followed by one row per app. Columns: name, clientId, types, labels, status, lastModifiedDate.

Multi-valued types and labels are semicolon-separated within a single CSV cell. Apps without any labels have an empty string in the labels column. Apps where signOnMode isn't OPENID_CONNECT have an empty clientId.

Response

name,clientId,types,labels,status,lastModifiedDate
"Okta Salesforce",,SAML;PROVISIONING,"billing;sox",ACTIVE,2026-06-20T12:34:56Z
"Okta Workflows",0oa11qqppWT4SSHNp0g5,OIDC,,ACTIVE,2026-06-24T07:44:42Z
"ApiServiceApp",0oa3ck4vIANix4RD90g4,OIDC;API_SERVICE,"internal-tools",ACTIVE,2026-06-11T06:59:46Z
"Legacy SWA App",,SWA,"legacy",INACTIVE,2025-11-03T18:22:10Z
"Zoom",,SAML;PROVISIONING;UNIVERSAL_LOGOUT,"video;sox",ACTIVE,2026-05-15T14:08:33Z