Skip to main content

Protocol discovery

GET /v1/protocol returns the base URL of the DFOS protocol relay:

curl https://api.dfos.com/v1/protocol
{
"relayUrl": "https://relay.dfos.com"
}

Every did this API emits — on spaces, on authors, and on future entities — is a protocol DID resolvable on that relay. Rather than hardcoding relay.dfos.com, fetch it here: the relay URL is per deployment stage, and discovering it keeps your client pointed at the right one. Combine the relayUrl with a did to resolve its identity chain, e.g. {relayUrl}/proof/v1/identities/{did}.

The relay is a read-only public window onto protocol data — identity chains, public profile documents, and public post content chains, verifiable without trusting the API. See Relays & verification for what it serves and how to check it, and The protocol for the identity-and-authorship model underneath DFOS.