Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Simple hello to the network that returns some useful information. This can be used for discovery.
A QR code that maps to a URL to adopt the device. Send it to someone to scan to adopt the device.
Adopt code
Get account preferences.
Retrieves the paid and unpaid byte count provided to the network
Unique network code to refer new users
udid
Check if the network name is available. A new network name must satisfy:
Fetches the payout wallet associated with the network
udid
A QR code that maps to a URL to add the shared device. Send it to someone to scan to add the device.
Share code
Change password.
Authenticate with an auth code. The returned session is tied to the session that created the auth code, and will be expired with any of the creator's sessions. This is a subset of an OAuth flow.
Remove an adopt code. This must be called from the side that initiates the adoption.
Send verification code to email or phone number.
email or phone number
email or phone number
Send password reset code to email or phone number.
email or phone number
email or phone number
The status of the adopt-code device. The status can be one of:
Initialize the Circle USDC user self custody wallet. This starts a process that must be completed by the user.
Set account preferences.
Verify ownership of email or phone number.
email or phone number
Validate a USDC wallet address on the user custody wallet chain. This can be used to check whether an address can receive a transfer out from the user custody wallet. Please use this before initiating any transfer out to avoid lost funds.
Get the balance for the USDC user custody wallet. The user custody wallet allows BringYour to query the balance, but the user must take actions against the wallet.
Confirm the adoption of a device. This must be called from the side that initiates the adoption.
client auth
Create a limited use code (auth code) to share authentication
with connected apps and tools.
The code is tied to the caller session,
and will be expired with any of the caller's sessions.
Currently a code cannot be created for a client JWT
(from /network/auth-client
).
This is a subset of an OAuth flow.
Set an existing account wallet as the wallet to receive network payments.
udid
Remove a device association. The association can be any of:
Creates a code to adopt a device. The adopt code is valid for a limited time.
Name of the device that will be shared to the adopter
keep this secret locally to use with confirm
Remove a client from the network.
udid
Creates an anonymous payment identifier to be used with purchases. This keeps network information out of the payment processor system. For example in Google Play this is called the "obfuscated account id".
udid
The status of the shared device. The status can be one of:
Confirm the share of a device. This must be called from the side that initiates the share.
Set the name of the association.
To set the name of devices owned by the network, use /device/set-name
.
Name of the device
Sets the name of a device owned by the network.
To set the name of devices shared with the network, use /device/set-association-name
.
udid
Randomly sample providers that for a location or group, which are active and in good health. This allows random iteration by using the exclude input to mark visited providers.
udid
udid
udid
udid
Remove a wallet from your list of account wallets
udid
Wallet successfully removed
Password login for email and phone number.
email or phone number
email or phone number
Check if the balance code is valid.
Creates a code to share a device.
udid
Name of the device that will be shared to the guest
Create a spec object for find-providers2
using a description
of the intended use of the network.
description of the intended use of the connection
udid
udid
udid
Out-of-band control messages for the connect protocol. Blocking request-response control messages need to be handled out-of-band to resolve the possibility of dedlocks in the client sequence.
base64 encoded connect protobuf Pack
processed as control messages.
As an inline message, these would be sent to the control id.
base64 encoded connect Pack
resulting from processing the control messages.
As an inline message, this is what would be sent from the control id after processing the control messages.
Redeem the balance code and add the transfer balance to the caller network.
udid
Set up a transfer from the Circle USDC user self custody wallet to an address. This starts a process that must be completed by the user.
user consent to accept terms of transfer
Create a new wallet for your network. You can then use it as a payout wallet by posting to /account/payout-wallet.
The blockchain associated with the address
The "SOL" or "MATIC" wallet address
We only support "USDC"
udid
Gain permission to use the connect
protocol as the requested clientId,
or assign a new clientId.
Each network can have at most 128 clientIds.
Above that number, new clientId requests will error until one or more
existing clientIds are removed.
udid. Optional. If this is given, it must currently exist in the network. Omit this to assign a new client id.
If this is a new device, sets the device name to the description of the device.
If this is a new device, sets the device spec.
udid. Optional. | The client that the new client is derived from. If this is called with a client jwt, the derived client id is inferred from the jwt.
Start a login for a user authority. The user authority may be:
email or phone number
email or phone number
Set the provide mode for a device.
udid
Add a device, which can either be owned by the network or shared with the network. The code provided can be either adoption code or a share code. Once a code is added, the device becomes an associated device until confirmation. If the device is a shared device, it will remain an associated device after confirmation.
share code or adopt code
Name of the device shared by the owner
The name of the source network. Only for share codes.
udid. Only for share codes.
Create a new network. A user authority can be associated with at most one network.
email or phone number
user consent to accept terms of service
uuid
email or phone number
Feedback.
Get statistics for all providers in the caller network for the last 90 days. This is meant to answer the top level question of how the providers in a network are performing.
datetime
yyyy-mm-dd to hours
yyyy-mm-dd to gib
yyyy-mm-dd to payout USDC
yyyy-mm-dd to matching search count
yyyy-mm-dd to count
yyyy-mm-dd to count
Get a list of wallets associated with your network
A list of wallets associated with your network
udid
If the wallet was created through the Circle flow, it is the ID associated with the Circle wallet.
udid
Blockchain wallet address
datetime
Get all providers in the caller network. Each provider includes stats from the last 24 hours.
datetime
udid
datetime
hours up
gib
usdc
matching search count
Randomly sample providers for locations, groups, or devices, which are active and in good health. This allows random iteration by using the exclude input to mark visited providers.
udid
udid
udid
udid
udid
The devices associated with the caller network. Associated devices are:
devices pending adoption that need to be confirmed by the offerer
Name of the device
devices owned by another network shared to the caller network
Name of the device
udid
devices owned by the caller network shared to another network
Name of the device
udid
Get the current subscription status and transfer balance.
udid
udid
udid
udid
udid
Search for locations and groups that match a query,
where there are at least one active provider in good health.
The match algorithm accounts for typos and misspelling,
and the tolerance can be tuned in the input.
Note that a location or group will need to be mapped to an actual provider
using /network/find-providers
.
udid
udid
udid
udid
udid
udid
udid
udid
udid
Search for locations, groups, and devices that match a query, regardless of whether an providers are active.
udid
udid
udid
udid
udid
udid
udid
udid
udid
A list of locations and groups where there are at least one active provider
in good health.
Note that a location or group will need to be mapped to an actual provider
using /network/find-providers
.
udid
udid
udid
udid
udid
udid
udid
udid
udid
Get the latest status of all clients on this network.
Includes:
udid
udid
udid
udid
udid
udid
udid
udid
Get detailed stats on a single provider in the caller network. This is meant to give the user complete visibility over usage.
udid
datetime
yyyy-mm-dd to hours
yyyy-mm-dd to gib
yyyy-mm-dd to payout USDC
yyyy-mm-dd to matching search count
yyyy-mm-dd to count
yyyy-mm-dd to count
udid
yyyy-mm-dd to gib
Get network statistics for the last 90 days. The statistics are updated approximately every 60s.
Unix epoch time UTC
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count
yyyy-mm-dd to count