# List roles

<mark style="color:green;">`GET`</mark> \ <mark style="color:$primary;">**Url Produção:**</mark> `https://api.acessorh.com.br`\ <mark style="color:$primary;">**Url Homologação:**</mark> `https://api.rh.homolog.acesso.io`\ <mark style="color:$primary;">**Endpoint:**</mark> `/v1/role/:acc`

### **Headers**

| Key                                             | Type   | Description                                                   |
| ----------------------------------------------- | ------ | ------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | Token de acesso adquirido pela plataforma Identity *(bearer*) |

### **Path Parameters**

| Key                                   | Type   | Description                                                                                                                 |
| ------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| acc<mark style="color:red;">\*</mark> | string | UID da [empresa](https://devcenter.unico.io/unico-people/unico-people-v1/apis/organizacao) de onde os cargos serão listados |

{% hint style="warning" %}
É <mark style="color:$warning;">**obrigatório**</mark> informar o parametro de <mark style="color:$success;">**acc**</mark>.\
\
Não é possível trazer de todos acc's de uma vez, caso tenha mais de um na instancia.
{% endhint %}

### **Query Parameters**

| Key   | Type   | Description                                                 |
| ----- | ------ | ----------------------------------------------------------- |
| limit | string | Limite de cargos que serão listados (paginação)             |
| skip  | string | Indica a quantidade de cargos que serão pulados (paginação) |
| code  | string | Código do cargo que deverá ser filtrado                     |

{% hint style="warning" %}
Caso não seja inserido os parâmetros `limit` e `skip` , os valores padrões serão, respectivamente, 1000 e 0.

O parâmetro `limit` tem o seu valor máximo como 1000.
{% endhint %}

### Exemplo de requisição <a href="#exemplo-de-requisicao" id="exemplo-de-requisicao"></a>

```json
curl --location 'https://api.acessorh.com.br/v1/role/uid da empresa' \
--header 'Authorization: Bearer token de auth'
```

### Exemplo de response <a href="#exemplo-de-requisicao" id="exemplo-de-requisicao"></a>

{% code title="200 OK" %}

```json
[
    {
        "acc": "bf63e2bd-da94-4bc3-862d-49daf9fadb87",
        "code": "an-prog-jr",
        "context": {
            "brazil": {
                "cbo": "789",
                "escolaridadeMinima": "superior_completo"
            }
        },
        "id": "3a46ca19-506f-4e80-a217-891d48a2a0ac",
        "name": "Analista Programador Jr"
    }
]
```

{% endcode %}
