Listar cards em uma fase específica

Retorna todos os cards vinculados a uma fase específica utilizando seu identificador único (id).

Este endpoint permite consultar os cards pertencentes a uma determinada fase dentro do fluxo do Board, possibilitando integrações para monitoramento, sincronização e gerenciamento de processos específicos da plataforma.

As informações retornadas podem incluir dados dos cards, responsáveis, fases e demais informações disponíveis conforme as permissões do usuário autenticado.

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/cards/phase/12345

Neste exemplo:

12345

Corresponde ao ID da fase consultada.

Exemplo de resposta

[
  {
    "id": "10001",
    "title": "Goalfy",
    "phase": "Em andamento",
    "responsible": "Goalfy"
  },
  {
    "id": "10002",
    "title": "Goalfy",
    "phase": "Em andamento",
    "responsible": "Goalfy"
  }
]

✅

Respostas esperadas

Sucesso 200

Retorna todos os cards vinculados à fase informada.

❗

Possíveis erros

404 Not Found

Retornado quando a fase informada não existe ou não foi localizada.

401 Unauthorized

Retornado quando o token de autenticação é inválido ou não foi enviado corretamente.

403 Forbidden

Retornado quando o usuário não possui permissão para acessar a fase informada.

Observações

⚠️

Importante

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

• Algumas fases podem não possuir cards cadastrados.
• Dependendo da configuração do Board, determinados campos podem retornar valores nulos.
• Recomenda-se validar o ID da fase antes de realizar integrações automatizadas.
• Certifique-se de informar um ID válido para evitar erros de consulta.

FAQ?

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