# List apps

Endpoint: GET /v1/apps
Version: v1
Security: x-api-key

## Security:

  - `x-api-key` (unknown)
    apiKey in header x-api-key

## Query parameters:

  - `creationTimestampAfter` (integer)
    Filter by when the app was first observed - start time. This is a UNIX timestamp (in seconds).

  - `creationTimestampBefore` (integer)
    Filter by when the app was first observed - end time. This is a UNIX timestamp (in seconds).

  - `limit` (integer)
    Used for pagination. Number of objects to return.

  - `offset` (integer)
    Used for pagination. Number of objects to skip. Cannot be set when `nextToken` is also set.

  - `nextToken` (string)
    Used for pagination. Token to be used for the next request. Cannot be set when `offset` is also set.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `result` (array)

  - `result.id` (string)
    Unique identifier for this object
    Example: 2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0

  - `result.type` (string)
    The type of app, formatted as an ENUM value.
    Example: ZAPIER

  - `result.approvalStatus` (string)
    Approval status of the app, `null` if not set
    Enum: "UNDER_REVIEW", "APPROVED", "NOT_APPROVED"

  - `result.sensitivityLevel` (string)
    The sensitivity level of the app, `null` if not set
    Enum: "HIGH", "MEDIUM", "LOW"

  - `result.ownerId` (string)
    Identifier of the employee who is the owner of this platform
    Example: 87569da6-fb7a-4df7-8ce2-246c14044911

  - `result.notes` (string)
    Notes recorded on this app
    Example: Last security audit: 16 January 2023

  - `result.website` (string)
    URL to the app's homepage
    Example: https://zapier.com/

  - `result.description` (string)
    Description of the app's purpose
    Example: Zapier is a cloud-based automation tool that enables users to integrate and automate various web applications without requiring extensive coding knowledge, potentially streamlining workflows and proce…

  - `result.friendlyName` (string)
    The friendly name of the app
    Example: Zapier

  - `result.labels` (array)
    Labels associated with this app
    Example: ["GenAI","marketing"]

  - `result.categories` (array)
    Categories associated with this app

  - `result.categories.code` (integer, required)
    Numeric code identifying the category
    Example: 83

  - `result.categories.name` (string, required)
    Name of the category
    Example: AI/ML Applications

  - `result.categories.group` (string, required)
    The group this category belongs to
    Example: Technology

  - `result.creationTimestamp` (integer)
    When the app was first observed, formatted as a UNIX timestamp (in seconds)
    Example: 1698064423

  - `paging` (object)

  - `paging.moreResults` (boolean)
    Whether there are more results available
    Example: true

  - `paging.next` (string)
    Start of the next page that can be used as the `offset` for the next request
    Example: 501

  - `paging.nextToken` (string)
    Start of the next page that can be used as the `nextToken` for the next request.
    Example: 0b9972aa-fe8d-4095-82d3-2e13cf3cfd43

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 422:

  - `422` (unknown)
    The requested page of results is larger than the 1MB response size limit. Lower the `limit` parameter.

