<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "apple-school-and-business-manager-api",
  "identifier" : "/documentation/AppleBusinessAPI/Get-Configurations",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Business API"
    ],
    "preciseIdentifier" : "rest:AppleBusinessAPI:get:v1-configurations"
  },
  "title" : "Get Configurations"
}
-->

# Get Configurations

Get a list of Configurations in an organization.

## Overview> Note: this API will return `null` for `customSettingsValues` for all configuration types, including of type `CUSTOM_SETTING`. To get the `customSettingsValues` for `CUSTOM_SETTING` Configurations, see <doc://com.apple.apple-school-and-business-manager-api/documentation/AppleBusinessAPI/Get-Configuration-Information>.

### Example

**Request:**

```
curl "https://api-business.apple.com/v1/configurations" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}"
```

**Response:**

```json
{
  "data": [
    {
      "type": "configurations",
      "id": "config-12345",
      "attributes": {
        "type": "CUSTOM_SETTING",
        "name": "Wi-Fi Configuration",
        "configuredForPlatforms": [
          "PLATFORM_IOS",
          "PLATFORM_MACOS"
        ],
        "customSettingsValues": null,
        "createdDateTime": "2024-01-15T10:30:00Z",
        "updatedDateTime": "2024-06-01T14:22:00Z"
      },
      "links": {
        "self": "https://api-business.apple.com/v1/configurations/config-12345"
      }
    },
    {
      "type": "configurations",
      "id": "config-2345",
      "attributes": {
        "type": "AIR_DROP",
        "name": "Air Drop Configuration",
        "configuredForPlatforms": [
          "PLATFORM_IOS",
        ],
        "customSettingsValues": null,
        "createdDateTime": "2024-01-15T10:30:00Z",
        "updatedDateTime": "2024-06-01T14:22:00Z"
      },
      "links": {
        "self": "https://api-business.apple.com/v1/configurations/config-2345"
      }
    }
  ],
  "links": {
    "self": "https://api-business.apple.com/v1/configurations",
    "next": "https://api-business.apple.com/v1/configurations?cursor=MDowOjE3NDYxMTM4OTI1OTA"
  },
  "meta": {
    "paging": {
      "nextCursor": "MDowOjE3NDYxMTM4OTI1OTA",
      "limit": 2
    }
  }
}
```

## Topics

### Responses

[`object ConfigurationsResponse`](/documentation/AppleBusinessAPI/ConfigurationsResponse)

A response that contains a list of Configuration resources.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)