---
updatedAt: 2026-03-01T18:37:26.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/property-mgr/llms.txt
---

# List available behaviors for a property

```curl cURL
propertyVersion="3"
propertyId="prp_175780"
contractId="ctr_1-1TJZFW"
groupId="grp_15166"

egcurl --eg-section default --request GET \

  --url "https://$hostname/papi/v1/properties/$propertyId/versions/$propertyVersion/available-behaviors?contractId=$contractId&groupId=$groupId" \
  --header "Accept: application/json"
  --header "PAPI-Use-Prefixes: true"
```

```node Node
const EdgeGrid = require("akamai-edgegrid");
const os = require("os");
const edgercPath = os.homedir + "/.edgerc.txt";
const edgercSection = "default";  
const eg = new EdgeGrid({
  path: edgercPath,
  section: edgercSection
});   

const propertyVersion = "3";
const propertyId = "prp_175780";

eg.auth({
  path: `/papi/v1/properties/${propertyId}/versions/${propertyVersion}/available-behaviors`,
  method: "GET",
  headers: {
    
    "Accept": "application/json",
    "PAPI-Use-Prefixes": "true"},
  qs: {
    "contractId": "ctr_1-1TJZFW",
    "groupId": "grp_15166"
}                    
});
eg.send(function(error, response, body) {
  console.log(body);    
});
```

```python Python
import requests
from akamai.edgegrid import EdgeGridAuth, EdgeRc
from urllib.parse import urljoin

edgerc = EdgeRc('~/.edgerc.txt')
section = 'default'
baseurl = 'https://%s' % edgerc.get(section, 'host')

session = requests.Session()
session.auth = EdgeGridAuth.from_edgerc(edgerc, section)
propertyVersion = "3"
propertyId = "prp_175780"
 

path= '/papi/v1/properties/{}/versions/{}/available-behaviors'.format(propertyId, propertyVersion)
headers = {
  
  "Accept": "application/json",
  "PAPI-Use-Prefixes": "true"
} 
querystring = {
  "contractId": "ctr_1-1TJZFW",
  "groupId": "grp_15166"
}  

result = session.get(urljoin(baseurl, path), headers=headers, params=querystring)
print(result.status_code)
print(result.json())  
```

```json Response Example
{
    "contractId": "ctr_1-1TJZH5",
    "groupId": "grp_15225",
    "productId": "prd_Alta",
    "ruleFormat": "v2015-08-08",
    "behaviors": {
        "items": [
            {
                "name": "cpCode",
                "schemaLink": "/papi/v1/schemas/products/prd_Alta/latest#/definitions/catalog/behaviors/cpCode"
            },
            {
                "name": "origin",
                "schemaLink": "/papi/v1/schemas/products/prd_Alta/latest#/definitions/catalog/behaviors/origin"
            }
        ]
    }
}
```

# Set up authentication

<!-- curl@6 -->
<!-- node@1-8 -->
<!-- python@1-10 -->

If you haven't already, you need to [create your authentication credentials](https://techdocs.akamai.com/developer/docs/set-up-authentication-credentials) in an API client in Control Center. Set up the API client with:

* Access to the Property Manager API (PAPI).
* PAPI's access level set to READ-WRITE.

Then, you can include this code to apply the token values to validate your requests.

# Form the request URL

<!-- curl@8 -->
<!-- node@14 -->
<!-- python@15 -->

Specify the target endpoint.

# Get property information

<!-- curl@0 -->
<!-- node@0 -->
<!-- python@0 -->

Run [list properties](https://techdocs.akamai.com/property-mgr/recipes/list-properties) to view all of your existing properties and locate the one you want to work with. Store these values:

* `propertyId`. The unique identifier ​Akamai​ assigned to the property.
* `contractId`. The unique identifier applied to the ​Akamai​ contract used to create the property.
* `groupId`. The unique identifier assigned to the group associated with the contract used to create the property, if applicable.
* `latestVersion`, `stagingVersion`, or `productionVersion`. Determine which version of the property you want to use, and store this value. You can review the rule tree for each version, using the [get a property rule tree](https://techdocs.akamai.com/property-mgr/recipes/get-a-property-rule-tree) operation.

# Set your headers

<!-- curl@9-10 -->
<!-- node@16-19 -->
<!-- python@16-20 -->

Include these headers:

* `Accept: application/json`
* `PAPI-Use-Prefixes`. This sets whether to represent ID prefixes in response data. Set to `false` when exchanging PAPI data with other APIs. Set it to `true` here because we're working in PAPI.

# Set property values

<!-- curl@1-2 -->
<!-- node@10-11 -->
<!-- python@11-12 -->

You need to name the specific property version to view its behaviors. Include both the `propertyVersion` and `propertyId` values you stored (step 2).

# Set your query string parameters

<!-- curl@3-4 -->
<!-- node@10-11,20-23 -->
<!-- python@21-24 -->

Include the `contractId` and `groupId` (if applicable) and use the values you stored (step 3).

# Call the API

<!-- curl@1-1000 -->
<!-- node@1-1000 -->
<!-- python@1-1000 -->

Call GET on the request URL.

# View the response

<!-- curl@0 -->
<!-- node@0 -->
<!-- python@0 -->

The response object lists the `behaviors` associated with the specified `propertyVersion`, `propertyId`, `contractId`, and `groupId`. 

You can use the `schemaLink` URL for each behavior to poll the API and get a JSON schema output example.