# Get Labels

## Retrieve a list of available labels

> Retrieves a list of available labels in the iSlash system.

```json
{"openapi":"3.0.0","info":{"title":"iSlash API","version":"1.0.1"},"servers":[{"url":"https://{ISLASH_API_ENDPOINT}/api/public","variables":{"ISLASH_API_ENDPOINT":{"default":"{ISLASH_API_ENDPOINT}","description":"The base hostname for the iSlash API platform."}}}],"paths":{"/label":{"get":{"summary":"Retrieve a list of available labels","description":"Retrieves a list of available labels in the iSlash system.","parameters":[{"in":"header","name":"X-USER-TOKEN","schema":{"type":"string"},"required":true,"description":"The secret key provided by iSlash for accessing the iSlash API platform."},{"in":"query","name":"session","schema":{"type":"string"},"required":true,"description":"The session key generated by your admin to control which channel can send messages via the API."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"The response status code."},"message":{"type":"string","description":"A message describing the response status."}}},"data":{"type":"object","required":["labels"],"properties":{"labels":{"type":"object","required":["id","text","color"],"properties":{"id":{"type":"integer","description":"The label ID in the iSlash system."},"text":{"type":"string","description":"The name of the label."},"color":{"type":"string","description":"The color of the label.","nullable":true}}}}}}}}}}}}}}}
```

{% code title="Sample Response" %}

```json
{
    "meta": {
        "code": "RESP_OKAY",
        "message": "Success",
        "trace_id": "040a6b96021b42e3"
    },
    "data": {
        "labels": [
            {
                "id": 1,
                "text": "Unassigned",
                "color": "blue"
            },
            {
                "id": 2,
                "text": "Pending Payment",
                "color": "blue"
            },
            {
                "id": 3,
                "text": "Paid",
                "color": "blue"
            }
        ]
    }
}


```

{% endcode %}