# List applications (https://developer.godaddy.com/en/docs/references/rest/hosting/list-apps)

---
title: List applications
description: Returns a paginated list of applications for the authenticated user.
full: true
---

Full description

> Returns a paginated list of applications for the authenticated user. `appType` is required. Cross-product listing will be supported in a future version.

## GET /apps

List applications

Returns a paginated list of applications for the authenticated user. `appType` is required. Cross-product listing will be supported in a future version.


### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `appType` | unknown | yes | Product type to scope the operation to. |
| `pageToken` | unknown | no | Opaque pagination cursor. Clients should navigate by following `links[rel=next].href` from the previous response rather than constructing URLs manually; this parameter is documented so that the endpoint's contract is discoverable. |
| `pageSize` | unknown | no | Maximum number of items to return. |
| `totalRequired` | unknown | no | When `true`, populate `totalItems` in the response. This may impact response time on large collections. |

### Responses

**200** — Paginated list of applications.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/PagedApplications`

**400** — The request body or parameters did not pass schema validation.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**401** — Authentication credentials are missing or invalid.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**403** — The caller is authenticated, but the request is not permitted: either the access token does not carry the scope this operation requires, or the operation is disabled for this account.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**429** — Rate limit exceeded. A `429` response may come in one of two shapes: an empty body with `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` headers; or a JSON `Error` body with `Retry-After` and `RateLimit-*` headers. Clients should honour whichever headers are present and should not assume a JSON body is available on every `429`.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**503** — The service is temporarily unable to handle the request. Retry after a short delay. May include a `Retry-After` header hinting at when to retry.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**Security:** requires `bearerAuth`.