Listar fase específica

Retorna todas as informações de uma fase específica a partir do seu identificador único (id).

Este endpoint permite consultar os dados completos de uma fase dentro de um Board, incluindo informações de configuração, identificação e demais dados relacionados ao fluxo em que a fase está inserida.

É recomendado para integrações que necessitam consultar detalhes de uma fase específica antes de realizar operações relacionadas a cards, automações ou movimentações dentro do Board.

Parâmetros utilizados

id da Fase

Identificador único da fase que será consultada.

O ID deve ser informado diretamente na rota da requisição.

Exemplo:

GET https://api.goalfy.com.br/api/phases/12345

Neste exemplo:

12345

Corresponde ao ID da fase consultada.

Exemplo de Resposta

{
    "color": "--choice-gray-900",
    "createdAt": "2026-05-05T00:00",
    "description": "Fase que recebe todos os cards novos.",
    "id": "12345",
    "index": 0.0,
    "model": {
        "createdAt": "2026-05-05T00:00",
        "fields": [
          {
            ...
				  }
    		],
    "slaConsiderOnlyBusinessDays": false,
    "slaTimeBeforeDue": "0;minutes",
    "slaTimeBeforeDueEnabled": false,
    "title": "Caixa de Entrada",
    "totalizerEnabled": false,
    "updatedAt": "2026-05-14T00:00"
}

Observações

🚧

Importante

O retorno da requisição pode variar conforme as permissões do usuário autenticado.

• A fase deve pertencer a um Board acessível pelo usuário autenticado.
• Alguns dados podem não ser retornados dependendo das permissões configuradas na organização.
• Recomenda-se armazenar o ID da fase para futuras consultas e integrações.
• O identificador retornado pode ser utilizado em endpoints relacionados a cards, campos e movimentações de fluxo.

FAQ?

Perguntas frequentes que fazem.
Segue abaixo cards que podem te ajudar a tirar essas dúvidas: