Use the CMDB meta API to obtain meta data on a CMDB class.

These APIs require that the user have the ITIL role.

CMDB meta API - GET - /now/cmdb/meta/{classname}

Read meta data for a CMDB class.

URL format

Versioned URL: api/now/v1/cmdb/meta/{className}

Default URL: api/now/cmdb/meta/{className}

The path parameter.
  • className - The CMDB class name.

Supported request parameters

Table 1. Parameters
Parameter Description


The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 2. Request headers
Header Description
Table 3. Response headers
Header Description

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST response codes .

Table 4. Status codes
Status code Description

Response body

The API returns these JSON or XML elements in the response body.
{"result": {
  "parent": "cmdb_ci",
  "children": [
  "attributes": [{
    "label": "TCP port(s)",
    "type": "string",
    "element": "tcp_port",
    "max_length": "255"},
     "label": "Skip sync",
     "type": "boolean",
     "element": "skip_sync",
     "max_length": "40"},
      "label": "Operational status",
      "type": "integer",
      "element": "operational_status",
      "max_length": "40"}],
  "identification_rules": {
     "related_rules": [],
     "depends_on": [{
       "parent": "cmdb_ci_appl",
       "relation_type": "60bc4e22c0a8010e01f074cbe6bd73c3",
       "child": "cmdb_ci_hardware"}],
  "applies_to": "cmdb_ci_appl",
  "identifiers": [{
     "fields": [
     "priority": 100,
     "active": true,
     "valid": true,
     "fallbackAllowed": false,
     "nullValueAllowed": true,
     "exactCountMatch": false,
     "entrySysId": "8985a23ec3f00200d8d4bea192d3ae08"}],
  "name": "Application Rule",
  "is_independent": false}}}