Lista os convidados

GET/api/visitors/spaces/{spaceId}/invitations

Auth: Requiere token
X-CommunityId: X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.

Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

O membro vê **só os seus** (os que ele recebe ou cadastrou), em qualquer data. Moderador e financeiro veem também os esperados **de hoje** (todos os anfitriões). Owner e admin veem qualquer data. Ordem por horário esperado. `status` aceita `EXPECTED` (hoje em diante), `ARRIVED`, `CANCELED` e `NO_SHOW` (derivado: esperado de um dia que já passou). `from` e `to` são dias `AAAA-MM-DD` (inclusivos) no fuso da comunidade.

Parámetros

Nombre	Dónde	Tipo	Descripción
`spaceId`obligatorio	path	`string (uuid)`
`status`opcional	query	`EXPECTED \| ARRIVED \| CANCELED \| NO_SHOW`
`from`opcional	query	`string`	AAAA-MM-DD
`to`opcional	query	`string`	AAAA-MM-DD
`q`opcional	query	`string`	Parte do nome ou da empresa.
`hostProfileId`opcional	query	`string (uuid)`	Só os convidados deste anfitrião (vale dentro do que quem chama já pode ver; útil para owner e admin).
`page`opcional	query	`integer`
`limit`opcional	query	`integer`

Headers

Nombre	Tipo	Descripción
`X-CommunityId`opcional	`string (uuid)`	ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

Código	Descripción
`200`	Página de convidados.
`400`	Requisição inválida — falha de validação.
`401`	Token ausente, inválido ou expirado.
`403`	Autenticado, mas sem permissão para esta operação.
`404`	Recurso não encontrado.
`500`	Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/visitors/spaces/<spaceId>/invitations" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"