Skip to main content
GET
/
shield_lists
cURL
curl -i -X GET "https://api.box.com/2.0/shield_lists" \
     -H "box-version: 2025.0" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
{
  "entries": [
    {
      "id": "12345678-1234-1234-1234-123456789012",
      "type": "shield_list",
      "name": "My Shield List",
      "content": {
        "type": "country_code"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
box-version
enum<string>
required

Version header.

Available options:
2025.0

Response

200 - application/json

Returns the list of shield list objects.

List of Shield List objects.

​
entries
Shield List (Mini) · object[]

A list of shield list objects.