GET /user/info

Get an authenticated Coil user's resources

GET https://api.coil.com/user/info

Before you can get a Coil user's resources, they must grant your app permission to access it.

Query headers

Key

Value

Content-Type

application/x-www-form-urlencoded

Authorization Bearer

Bearer access_token, where access_token is the JWT-format access token granted to your app through /oauth/token.

No encoded information is required in the body.

Example request

curl -X GET \
'https://api.coil.com/user/info' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Authorization: Bearer eyJhbGciOi...JSUzI1NfsQ' \
-d ''

Response parameters

The response is a JSON object containing Coil user resources.

Parameter

Type

Scope

Description

email

string

email

The user's email address, if authorized for the email scope.

sub

string

simple_wm

The user's unique and permanent ID. The ID will never change.

Example response using the simple_wm and email scopes

{
"email": "alice@coil.com",
"sub": "22028a7c-b720-7a3e-4387-6c9845f6201b",
}

Next: Generate a bilateral transfer protocol (BTP) token for the Coil user.