---
title: "Retorna filas de captadores para a Área do Cliente/APP"
method: GET
path: "/Usuario/App_RetornarFilasCaptacao"
tags: ["Usuario"]
---

# Retorna filas de captadores para a Área do Cliente/APP

`GET /Usuario/App_RetornarFilasCaptacao`

## Request

- Base URL: `https://api.imoview.com.br`
- URL: `https://api.imoview.com.br/Usuario/App_RetornarFilasCaptacao`
- Auth: one of:
  - API key in header `chave`
  - API key in header `codigoacesso`

Retorno JSON de filas de captadores para área do cliente/APP do imoview ADM

## Query parameters

- `codigoUsuario` integer, required
- `codigoUnidade` integer, required
- `finalidade` integer, required
- `codigoFila` integer, required

## Response `200`

Retornado com sucesso

- object
  - `fila_venda` object[]
    - `codigo` integer
    - `nome` string, string
    - `posicao` integer
  - `fila_aluguel` object[]
    - `codigo` integer
    - `nome` string, string
    - `posicao` integer
  - `fila_indisponivel_venda` object[]
    - `codigo` integer
    - `nome` string, string
  - `fila_indisponivel_aluguel` object[]
    - `codigo` integer
    - `nome` string, string

## Other responses

- `401`: Header 'chave' ou 'codigoacesso' ausente ou inválido, ou sem permissão para a operação
- `403`: Regra de negócio violada ou limite de paginação excedido
- `404`: Parâmetro obrigatório ausente ou inválido, registro não encontrado ou consulta sem resultado
- `429`: Limite de requisições da chave excedido
- `500`: Falha interna não prevista

## Changes

- **2026-10-09** `d7f65bff1506`: 10 breaking, 5 info
  - for the `query` request parameter `codigoFila`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `codigoUnidade`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `codigoUsuario`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `finalidade`, the format changed from `Int64` to `int64`
  - …11 more

[Operation history](https://skmtc.dev/imoview/apis/imoview-api/changes/Usuario/App_RetornarFilasCaptacao/get.md)

---

[API](https://skmtc.dev/imoview/apis/imoview-api.md) - [All operations](https://skmtc.dev/imoview/apis/imoview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/imoview/apis/imoview-api/revisions/436e609983d0?raw)