@tomcurran docs are coming soon, hopefully tomorrow. As a preview, to call the /me endpoint with curl:
curl -H 'Authorization: token ACCESSTOKEN' https://api.bitrise.io/v0.1/me
Where Acess Token is the token you can generate on your Account Settings page, under Security -> related #changelog : Personal Access Tokens (BETA)