---
title: "GET /v1/profiles"
method: GET
path: "/v1/profiles"
tags: ["Profiles"]
---

# GET /v1/profiles

`GET /v1/profiles`

## Query parameters

- `filter[name]` string[]
- `filter[profileState]` string[]
- `filter[profileType]` string[]
- `filter[id]` string[]
- `sort` string[]
- `fields[profiles]` string[]
- `limit` integer
- `include` string[]
- `fields[certificates]` string[]
- `fields[devices]` string[]
- `fields[bundleIds]` string[]
- `limit[certificates]` integer
- `limit[devices]` integer

## Response `200`

List of Profiles

- ProfilesResponse
  - `data` Profile[], required
    - `attributes` object
      - `createdDate` string, date-time
      - `expirationDate` string, date-time
      - `name` string
      - `platform` 'IOS' | 'MAC_OS'
      - `profileContent` string
      - `profileState` 'ACTIVE' | 'INVALID'
      - `profileType` 'IOS_APP_DEVELOPMENT' | 'IOS_APP_STORE' | 'IOS_APP_ADHOC' | 'IOS_APP_INHOUSE' | 'MAC_APP_DEVELOPMENT' | 'MAC_APP_STORE' | 'MAC_APP_DIRECT' | 'TVOS_APP_DEVELOPMENT' | 'TVOS_APP_STORE' | 'TVOS_APP_ADHOC' | 'TVOS_APP_INHOUSE' | 'MAC_CATALYST_APP_DEVELOPMENT' | 'MAC_CATALYST_APP_STORE' | 'MAC_CATALYST_APP_DIRECT'
      - `uuid` string
    - `id` string, required
    - `links` ResourceLinks, required
      - `self` string, uri-reference, required
    - `relationships` object
      - `bundleId` object
        - `data` object
          - `id` string, required
          - `type` 'bundleIds', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `certificates` object
        - `data` object[]
          - `id` string, required
          - `type` 'certificates', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `devices` object
        - `data` object[]
          - `id` string, required
          - `type` 'devices', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
    - `type` 'profiles', required
  - `included` union[]
    - union
      - BundleId
        - `attributes` object
          - `identifier` string
          - `name` string
          - `platform` 'IOS' | 'MAC_OS'
          - `seedId` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `bundleIdCapabilities` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `profiles` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'bundleIds', required
      - Device
        - `attributes` object
          - `addedDate` string, date-time
          - `deviceClass` 'APPLE_WATCH' | 'IPAD' | 'IPHONE' | 'IPOD' | 'APPLE_TV' | 'MAC'
          - `model` string
          - `name` string
          - `platform` 'IOS' | 'MAC_OS'
          - `status` 'ENABLED' | 'DISABLED'
          - `udid` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'devices', required
      - Certificate
        - `attributes` object
          - `certificateContent` string
          - `certificateType` 'IOS_DEVELOPMENT' | 'IOS_DISTRIBUTION' | 'MAC_APP_DISTRIBUTION' | 'MAC_INSTALLER_DISTRIBUTION' | 'MAC_APP_DEVELOPMENT' | 'DEVELOPER_ID_KEXT' | 'DEVELOPER_ID_APPLICATION' | 'DEVELOPMENT' | 'DISTRIBUTION'
          - `displayName` string
          - `expirationDate` string, date-time
          - `name` string
          - `platform` 'IOS' | 'MAC_OS'
          - `serialNumber` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'certificates', required
  - `links` PagedDocumentLinks, required
    - `first` string, uri-reference
    - `next` string, uri-reference
    - `self` string, uri-reference, required
  - `meta` PagingInformation
    - `paging` object, required
      - `limit` integer, required
      - `total` integer, required

## Other responses

- `400` — Parameter error(s)
- `403` — Forbidden error

---

[API](https://skmtc.net/apple/apis/app-store-connect.md) · [All operations](https://skmtc.net/apple/apis/app-store-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apple/app-store-connect/revisions/e085db5c8896/schema)