Listar cards em um board específico

Descrição:

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retorna todos os cards vinculados a um board específico utilizando seu identificador único (id).

Este endpoint permite consultar os cards pertencentes a um determinado Board dentro da plataforma, incluindo informações relacionadas aos cards, fases, responsáveis e demais dados disponíveis conforme as permissões do usuário autenticado.

É recomendado para integrações que necessitam listar, sincronizar ou monitorar cards de um Board específico.


Parâmetros utilizados

id do Board

Identificador único do Board que será consultado.

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

Exemplo:

GET https://api.goalfy.com.br/api/cards/board/12345

Neste exemplo:

12345

Corresponde ao ID do Board consultado.


Exemplo de resposta

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

✅

Respostas esperadas

Sucesso 200

Retorna todos os cards vinculados ao Board informado.


❗

Possíveis erros

404 Not Found

Retornado quando o Board informado não existe ou não foi localizado.

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 o Board informado.


Observações

⚠️

Importante

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

  • Alguns Boards podem não possuir cards cadastrados.
  • Dependendo da configuração do Board, determinados campos podem retornar valores nulos.
  • Recomenda-se utilizar filtros e paginação em integrações com grande volume de cards, quando disponível.
  • 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:

Path Params
string
required
Defaults to {id}
Headers
string
required
Defaults to "Token YOUR_TOKEN"
Response
200
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!