# Pin Types

## List pin types

**get** `/pin-types`

Returns a list of available pin types (colors and labels) for the authenticated company.

### Header Parameters

- `"rotor-api-version": "1.1.0"`

  - `"1.1.0"`

### Returns

- `data: optional array of object { id, color, label }`

  - `id: string`

  - `color: string`

    Hex color code for the pin

  - `label: string`

    Display label for the pin type

- `status: optional string`

### Example

```http
curl https://api.getrotor.com/open-api/pin-types \
    -H "x-api-key: $ROTOR_API_KEY"
```

#### Response

```json
{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "color": "#FF0000",
      "label": "High Priority"
    }
  ],
  "status": "success"
}
```