# Get Label

Reads a label’s name, notes, usage count and first 20 objects carrying it, with types, IDs and app link.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "labelId": {
      "type": "integer",
      "description": "ID of the label, from search-labels",
      "minimum": 1
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account of the access token",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "labelId"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "labelId",
    "name",
    "notes",
    "usageCount",
    "usedBy",
    "editUrl"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "labelId": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "usageCount": {
      "type": "integer"
    },
    "usedBy": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "type"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      }
    },
    "editUrl": {
      "type": "string"
    }
  }
}
```