Prerequisites

Before you begin, make sure you have set up your Privy app and obtained your app ID from the Privy Dashboard.

Base URL

All requests to the Privy API must be made to the following base URL:

https://api.privy.io

HTTPS is required for all requests. HTTP requests will be rejected.

Authentication

All API endpoints require authentication using Basic Auth and a Privy App ID header. Include the following headers with every request:

Authorization
string
required

Basic Auth header with your app ID as the username and your app secret as the password.

privy-app-id
string
required

Your Privy app ID as a string.

Requests missing either of these headers will be rejected by Privy’s middleware.

Your Privy app ID and app secret can be found in the App settings > Basics tab for your app.

Examples

fetch('https://api.privy.io/v1/wallets', {
  method: 'GET',
  headers: {
    'Authorization': `Basic ${btoa('insert-your-app-id' + ':' + 'insert-your-app-secret')}`,
    'privy-app-id': 'insert-your-app-id',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Was this page helpful?