Skip to main content
GET
/
shield_lists
cURL
curl --request GET \
  --url https://api.box.com/2.0/shield_lists \
  --header 'Authorization: Bearer <token>' \
  --header 'box-version: <box-version>'
{
  "entries": [
    {
      "id": "12345678-1234-1234-1234-123456789012",
      "type": "shield_list",
      "name": "My Shield List",
      "content": {
        "type": "country_code"
      }
    }
  ]
}
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.