SuperSign - API Oficial
  1. Contatos
  • SuperSign API Pública
    • Introdução
      • Primeiro envelope em 5 minutos
      • Integrar com IA
      • Testar a API no Postman
      • Paginação e filtros
      • Catálogo de erros
      • Receitas em Node.js, PHP e Python
      • Changelog
      • Idempotência e erros
      • Estados do envelope
      • Webhooks
      • Limites de requisição
      • Criar um envelope a partir de um modelo
    • Referência da API
      • Conta
        • Consultar a conta da integração
        • Consultar capacidades da integração
        • Consultar o catálogo de capacidades
        • Listar chamadas da própria chave
        • Validar a chave de API
      • Envelopes
        • Excluir rascunho de envelope
        • Consultar histórico do envelope
        • Criar e enviar envelope numa chamada
        • Gerar URL de download do envelope em ZIP
        • Criar rascunho de envelope
        • Listar envelopes
        • Atualizar configurações do envelope
        • Enviar envelope
        • Consultar envelope
        • Mover envelope para outra pasta
        • Anular envelope
      • Participantes
        • Listar participantes do envelope
        • Aprovar participante aprovador
        • Recusar como participante aprovador
        • Corrigir contato do participante
        • Sincronizar participantes
        • Enviar lembrete ao participante
      • Documentos
        • Listar documentos do envelope
        • Substituir campos do documento
        • Listar campos do documento
        • Confirmar o PDF convertido de um DOCX
        • Validar um documento selado
        • Adicionar documento ao envelope
        • Gerar URL de download do documento
      • Contatos
        • Atualizar contato parcialmente
          PATCH
        • Listar envelopes do contato
          GET
        • Listar listas de contatos
          GET
        • Consultar lista de contatos
          GET
        • Criar contato
          POST
        • Listar contatos
          GET
        • Consultar contato
          GET
        • Atualizar contato
          PUT
        • Excluir contato
          DELETE
      • Equipe
        • Listar grupos da conta
        • Listar membros da conta
      • Pastas
        • Listar conteúdo da pasta
        • Consultar acesso da pasta
        • Excluir pasta
        • Renomear pasta
        • Mover pasta
        • Listar todas as pastas
        • Criar pasta
      • Convites
        • Listar convites da conta
      • Webhooks
        • Excluir webhook
        • Listar entregas de um webhook
        • Detalhar uma entrega de webhook
        • Reenviar uma entrega de webhook
        • Girar o segredo de assinatura do webhook
        • Criar webhook
        • Listar webhooks
        • Atualizar webhook
      • Modelos
        • Listar modelos
        • Consultar modelo
        • Criar envelope a partir de modelo
      • Auditoria e relatórios
        • Listar envelopes anulados
        • Relatório de envelopes
        • Relatório de uso por grupo
  1. Contatos

Consultar lista de contatos

Sandbox
Sandbox
GET
/v4/api/contact-lists/{listId}
Retorna uma lista de contatos com seus contatos paginados (page, perPage). Somente leitura; lista inexistente, de outra conta ou invisível ao usuário responsável responde 404.

Requisição

Parâmetros de Caminho

Parâmetros de Consulta

Respostas

🟢200OK
application/json
Sucesso
Headers

Bodyapplication/json

🟠401Não Autorizado
🟠403Proibido
🟠404Registo Não Encontrado
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v4/api/contact-lists/?page=undefined&perPage=undefined'
Response Response Example
200 - Exemplo 1
{
    "id": "string",
    "name": "string",
    "isPublic": true,
    "entriesCount": -9007199254740991,
    "canEdit": true,
    "createdAt": "2019-08-24T14:15:22.123Z",
    "updatedAt": "2019-08-24T14:15:22.123Z",
    "entries": [
        {
            "contactId": "string",
            "order": -9007199254740991,
            "name": "string",
            "email": "string",
            "phoneNumber": "string",
            "role": "string",
            "qualification": "string",
            "deliveryMethod": "string",
            "authMethod": "string",
            "isForeigner": true,
            "mandatoryView": true
        }
    ],
    "meta": {
        "page": 0,
        "perPage": 0,
        "totalPages": 0,
        "totalCount": 0
    }
}
Modificado em 2026-09-28 20:20:50
Página anterior
Listar listas de contatos
Próxima página
Criar contato
Built with