Saltar para o conteúdo principal
GET
curl

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

vasp_id
string<uuid>
obrigatório

O id de uma linha de GET /v3/travel-rule/vasps/.

Resposta

A entrada.

Um VASP do diretório ou um membro da rede Didit, com as rotas que a sua aplicação tem para o mesmo. Um cliente é membro da rede Didit apenas enquanto a sua aplicação estiver em produção, o seu Travel Rule estiver ativado, o seu perfil for detetável, tiver uma denominação social e um e-mail de conformidade confirmado, e a Didit não tiver marcado a aplicação como de teste, demonstração ou interna. Cada linha inclui também a avaliação de diligência devida partilhada (dd_score, risk_level, responsiveness, essential_checks) e a decisão, triagem de entidades e questionários próprios da sua aplicação, que nenhum outro cliente vê.

id
string<uuid>

O id da entrada, para GET /v3/travel-rule/vasps/{vasp_id}/.

kind
enum<string>

directory para uma entrada do diretório partilhado; didit para um membro da rede Didit.

Opções disponíveis:
directory,
didit
name
string
lei
string
jurisdiction
string

Código de país ISO 3166, tal como fornecido pela fonte.

domains
string[]

Os domínios web do VASP. Sempre vazios para membros da rede Didit.

reachable
boolean

Se a sua aplicação tem uma rota disponível para este VASP ou para uma das suas entidades de uma marca. Sempre true para um membro da rede Didit, exceto numa aplicação sandbox, onde todas as linhas são false.

aliases
object[]

Outros nomes pelos quais o VASP é identificado.

networks
object[]
routes
object[]
umbrella
object | null

A marca da qual esta entrada é uma entidade regulada. Nulo quando não faz parte de nenhuma.

entities
object[]

Para uma marca, as entidades regulamentadas que recebem as suas transferências. Uma transferência que indique a marca segue para a entidade acessível na jurisdição indicada (beneficiary_data.counterparty_vasp_jurisdiction); caso contrário, para a entidade atribuída pela análise de blockchain associada à carteira de destino; caso contrário, para a única entidade acessível quando nenhuma jurisdição for indicada. Nunca se escolhe entre duas entidades igualmente adequadas por suposição.

contacts
object[]

Os contactos da plataforma para este VASP e os da sua própria aplicação.

dd_status
enum<string>

Estado de verificação da Didit para a entrada, pontuado pela componente de verificação do dd_score. Sempre COMPLETED para um membro da rede Didit.

Opções disponíveis:
NOT_STARTED,
IN_PROGRESS,
COMPLETED,
REJECTED
dd_score
integer | null

A pontuação partilhada de diligência devida de uma entrada do diretório, de 0 a 100, onde quanto mais alto, mais seguro (consulte dd_score_semantic): a soma dos pontos em dd_score_breakdown. Nulo para um membro da rede Didit, que não é pontuado. Uma entrada ainda não avaliada (dd_assessed_at nulo) apresenta 0 com um risk_level vazio; por isso, consulte risk_level em vez da pontuação bruta.

Intervalo necessário: 0 <= x <= 100
reachable_rails
enum<string>[]

Vias registadas na entrada. Consulte as rotas para ver o que a sua aplicação pode utilizar hoje.

Opções disponíveis:
INTERNAL,
TRP,
GTR,
TRUST,
VERIFYVASP,
SYGNA,
EMAIL
is_didit_customer
boolean

true para um membro da rede Didit (dd_status é sempre COMPLETED, dd_score é null e risk_level fica vazio nestes casos) e para uma entrada do diretório associada a um cliente da Didit.

dd_score_breakdown
object

Um objeto por componente de dd_score. Componentes, o respetivo peso (máx.) e os respetivos códigos de motivo: jurisdiction, 25 (jurisdiction_not_high_risk, jurisdiction_high_risk, jurisdiction_unknown); verification, 15 (dd_status_completed, dd_status_in_progress, dd_status_not_started, dd_status_rejected); protocol, 15 (native_rail, email_only, no_rail); lei, 10 (lei_valid, lei_missing); history, 10 (history, no_history); essentials, 15 (essential_checks, no_essential_checks); responsiveness, 10 (responsive, unresponsive, responsiveness_unknown). Vazio para um membro da rede Didit.

dd_assessed_at
string<date-time> | null

Quando dd_score, risk_level e responsiveness foram calculados pela última vez: após uma troca com a entrada ser concluída, terminar, expirar, não corresponder ou ser recusada, quando a Didit atualiza ou faz a curadoria da entrada, e na atualização semanal do diretório. Nulo para um membro da rede Didit.

dd_score_semantic
enum<string>

Em que sentido o dd_score aponta: sempre higher_is_safer.

Opções disponíveis:
higher_is_safer
risk_level
enum<string>

A faixa em que dd_score se insere: LOW (70 ou mais), MEDIUM (40 a 69) ou HIGH (abaixo de 40). Vazio para um membro da rede Didit e para uma entrada ainda não avaliada. Filtre por este parâmetro com risk. A sua própria triagem sinalizada nunca altera este valor partilhado: em vez disso, define counterparty_risk_level como HIGH nas suas regras.

Opções disponíveis:
LOW,
MEDIUM,
HIGH,
responsiveness
object

Indica se o VASP responde a pedidos de Travel Rule: a percentagem de pedidos iniciados por clientes Didit em direção a ele nos últimos 90 dias que foram respondidos. Apenas contam os pedidos enviados através de uma via de rede ou protocolo, ou por e-mail para um endereço partilhado (o endereço de conformidade do registo ou um contacto da plataforma); um pedido enviado para um endereço introduzido manualmente por um cliente, ou para o contacto privado de um cliente, nunca conta. Um pedido expirado conta como não respondido; uma troca concluída, uma recusa ou uma divergência de dados contam como resposta; um pedido cancelado ou uma via inacessível não contam como nenhum dos dois. Sempre UNKNOWN com contagens a zero para um membro da rede Didit.

essential_checks
object

O relatório de verificações essenciais de uma entrada do diretório, construído exclusivamente a partir de fontes verificadas da plataforma: registo (um registo oficial lista o VASP: o registo provisório do MiCA da UE, o diretório público da TRISA ou o registo global de LEI), licença (uma autorização MiCA está registada e em vigor), domínio (o domínio da entrada corresponde ao respetivo endpoint TRP ou ao website indicado no seu registo) e lei (o respetivo registo LEI está ativo, emitido e consistente com os nomes e o país da entrada). O componente de verificações essenciais do dd_score é a proporção de verificações decididas com resultado positivo. Fica vazio até que a atualização semanal do diretório verifique a entrada pela primeira vez, e está sempre vazio para membros da rede Didit.

decision
object | null

A decisão da sua aplicação sobre este VASP ou, para uma entidade sem decisão própria, a da sua marca (inherited_from indica a marca). Nulo quando não existe nenhuma. Privada para a sua aplicação.

entity_screening
object | null

A triagem mais recente de sanções e notícias adversas da sua aplicação sobre este VASP. Nula se nunca o tiver analisado. Privada para a sua aplicação.

questionnaires
object[]

Os questionários de diligência prévia da sua aplicação com este VASP, os mais recentes primeiro. Privados para a sua aplicação.

Última modificação em 7 de novembro de 2026