> For the complete documentation index, see [llms.txt](https://devcenter.unico.io/unico-people/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devcenter.unico.io/unico-people/unico-people-v1/apis/posicoes/list-positions.md).

# List positions

Lista posições na empresa ou filial selecionada.

<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/positions`

### **Headers**

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

### **Parâmetros de busca obrigatórios**

| Key                                   | Type   | Description                                                                                                                         |
| ------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| acc<mark style="color:red;">\*</mark> | string | UID da empresa ou da filial que será filtrada. [Consulte aqui](/unico-people/unico-people-v1/apis/organizacao.md#get-organization). |

### **Parâmetros de busca opcionais**

| Key              | Type   | Description                                                                                   |
| ---------------- | ------ | --------------------------------------------------------------------------------------------- |
| admission\_date  | string | Data de admissão início e fim Formato: **AAAA-MM-DD,AAAA-MM-DD**                              |
| status           | string | Filtro de status das posições                                                                 |
| position\_number | string | Código da posição desejada                                                                    |
| limit            | string | Limite de posições que serão listadas. O valor máximo é 100 por pagina. (paginação)           |
| skip             | string | Indica a quantidade de posições que serão puladas (paginação)                                 |
| sort             | string | Configura um parâmetro de ordenação do resultado da listagem de posições com base nas opções. |
| order            | string | Ordena o resultado de forma crescente e decrescente ("asc" e "desc").                         |

### **Lista de status**

| Key | Type      | Description                                                                                 |
| --- | --------- | ------------------------------------------------------------------------------------------- |
| 210 | Invited   | Posição criada e convite enviado para o candidato                                           |
| 220 | Pending   | Candidato iniciou o processo de admissão, mas ainda não finalizou a entrega dos documentos. |
| 230 | Review    | Posição já analisada pela mesa, mas pendente de correção pelo candidato.                    |
| 240 | Analisys  | Todos os documentos entregues, aguardando análise da mesa.                                  |
| 400 | Completed | Documentos entregues e validados ou posição completada manualmente pelo RH.                 |
| 500 | Archived  | Posição arquivada.                                                                          |
| 501 | Declined  | Posição declinada.                                                                          |

### **Parâmetros de ordenação  (sort)**

| Key             | Type   | Description                                      |
| --------------- | ------ | ------------------------------------------------ |
| limit\_date     | string | Data limite para o preenchimento do cadastro.    |
| admission\_date | string | Data de admissão preenchida no cadastro da vaga. |
| created\_date   | string | Data em que o cadastro foi criado.               |
| updated\_date   | string | Ultima data de atualização do cadastro.          |
| completed\_date | string | Data de finalização do cadastro.                 |

{% hint style="info" %}
Caso não seja inserido os parâmetros <mark style="color:$warning;">`limi`</mark>`t` e <mark style="color:$warning;">`skip`</mark> , os valores padrões serão, respectivamente, 100 e 0.
{% endhint %}

### Exemplo de requisição

```json
curl --location 'https://api.acessorh.com.br/v1/positions?acc=UID%20da%20empresa&admission_date=2024-08-17%2C2024-09-16&limit=100&skip=0&status=500&order=asc&sort=admission_date' \
--header 'Authorization: Bearer Token de autorização' \
--data ''
```

### **Exemplo de response**

```json
200 OK 

{
    "offset": 0,
    "limit": 100,
    "count": 1,
    "positions": [
        {
            "admission_date": "2019-05-17T00:00:00Z", //deprecated
            "cost_center": "anywhere",
            "exame": {
                "clinica": "bcaaf3a8-b682-4809-83a7-83a73e867cb6",
                "comprovante": {
                    "filename": "exame.jpg",
                    "id": "5f0676ab-648a-4c3f-92c7-eedd1802d719",
                    "mimetype": "image/jpeg",
                    "path": "organization/896ffd1d-a3a9-43df-a2e8-eed057fe40e6/position/9e70b644-fce0-442a-af8a-40b00cbbb437/context/brazil/exame/5f0676ab-648a-4c3f-92c7-eedd1802d719.jpg"
                },
                "data": "2019-05-11T00:00:00Z",
                "hora": "2006-01-02T13:04:00Z",
                "nome": "Clinica Saude",
                "observacoes": "chegar cedo"
            },
            "id": "e8efddec-4a9e-4153-9e61-ce0056edf542",
            "jornada": "De segunda a sexta das 15 as 19",
            "num_matricula": "4242424",
            "pagamento": {
                "agente_integrador": null,
                "data_inicio": null,
                "data_termino": null,
                "deficiencia": false,
                "recorrencia": "mensalista",
                "valor": 4200,
                "vinculo": "clt"
            },
            "position_number": "pos-test",
            "profile": {
                "email": "john.doe@acessodigital.com.br",
                "id": "72421b50-c882-4684-8e10-c5a0522978e1",
                "mobile": "11991111111",
                "name": "John Doe",
                "photo": {
                    "filename": "foto-perfil.png",
                    "id": "c8d1c2a7-75d2-4615-a9e1-d93bd09570b6",
                    "mimetype": "image/png",
                    "path": "individual/23beac75-4722-4e14-96a4-72f69322471e/person/brazil/c8d1c2a7-75d2-4615-a9e1-d93bd09570b6.png"
                }
            },
            "decline": {
                "type": "DECLINED_BY_HR",
                "reason": "sem-retorno-candidato",
                "description": "descricao",
                "message": "declinado pela empresa",
                "creationDate": "31/03/2023 16:42:44"
            },
            "dates": {
                "limit_date": "2019-05-30T00:00:00Z",
                "admission_date": "2019-05-17T00:00:00Z"
            },
            "status": {
                "code": 501,
                "name": "decline"
            },
            "updated": "2019-04-23T18:10:16.892Z"
        }
    ]
}
```

{% file src="/files/ZLKehLR1aFf1GuQG6oEQ" %}

***