Skip to main content
GET
curl

Network states

A network sends for your application in one of two ways:
  • Your own membership (state: own_membership): a membership you connected in Marketplace. It always takes precedence.
  • Didit’s membership (state: live_through_didit): Didit carries your application as its own participant on GTR or Sygna, with the participant code the network gave you. Messages never carry Didit’s own code, and what the network sends to your participant code reaches your application.
Reaching a network through Didit’s membership takes three steps: submit the network questionnaire, have Didit approve it, then request the network. TRUST and VerifyVASP are reachable only through your own membership: TRUST admits members per VASP, and a VerifyVASP Enclave serves one VASP id, so you run your own. While Didit’s own membership of a network is not live, its state is didit_onboarding and nothing can send on it through Didit. state is configuration status, not a live health or delivery check.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Response

Network states, questionnaire and participants.

platform_networks_enabled
boolean

Whether network access through Didit's membership is open. While false, questionnaire saves, submissions and network requests answer 403.

questionnaire
object
participants
object[]
networks
object
read-only

Per network, how this application would send and why it cannot. No network, including GTR, is included by default: a network is reachable through your own connected membership, or through Didit's membership once Didit's membership of that network is live and your own participant on it is active. Not a live health or delivery check.