---
title: "Retorna uma gestão de time cadastrada"
method: GET
path: "/gestoes-time/{idtime}"
tags: ["Gestões de Time"]
---

# Retorna uma gestão de time cadastrada

`GET /gestoes-time/{idtime}`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

Esta API é responsável por retornar uma Gestão de time cadastrada no CV.

## Path parameters

- `idtime` integer, required

## Headers

- `email` string, required
- `token` string, required

## Response `200`

Gestão de Time

- object
  - `data` RetornarGestaoTime[]
    - `idtime` integer — ID do time
    - `time` string — Nome do time
    - `usuarios` object[] — Lista de usuários do time
      - `idusuario` integer — ID do usuário
      - `usuario` string — Nome do usuário
      - `categoria` string — Categoria do usuário
      - `nivel` string — Nível do usuário
    - `empreendimentos` object[] — Lista de empreendimentos do time
      - `idempreendimento` integer — ID do empreendimento
      - `empreendimento` string — Nome do empreendimento
    - `imobiliarias` object[]
      - `idimobiliaria` integer — ID da imobiliária
      - `imobiliaria` string — Nome da imobiliária
    - `corretores` object[]
      - `idcorretor` integer — ID do corretor
      - `corretor` string — Nome do corretor
    - `regioes` object[] — Lista de regiões do time
      - `idregiao` integer — ID da região
      - `regiao` string — Nome da região
  - `status` string — Status da resposta

## Other responses

- `204` — Requisição Incorreta! Nenhum time foi encontrado.
- `404` — Não encontrado!
- `500` — Erro interno!

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/versions/42bf5add8bf3/schema)