Returns an authorization code that can be exchanged for an access token and a refresh token. For a video demo in Postman, click here.

This endpoint supports the following methods:

  • GET



This endpoint supports both Basic authentication (recommended) and janrain-signed authentication.

How to Create an Authentication String

Base URL

The base URL for this endpoint is your Identity Cloud Capture domain; for example:


Your Capture domains (also known as Registration domains) can be found in the Console on the Manage Application page:


Example Request

This command returns an authorization code for the user with the ID 11521.

curl -G \
  -H "Authorization: Basic dXQ0YmdycmE3dzI4MmpjZm15cGZxeDlwemhxaGpqMmI6dW5qemU5bndrZnV5NmpwdzgzOHFwYTdhZDNoZG55YTY="\
  --data-urlencode redirect_uri=http://documentation.janraincapture.com/oauth \
  --data-urlencode id=11521 \
  --data-urlencode type_name=user \
      Running this command in Postman

Authorized Clients

  • owner 
  • access_issuer

Query Parameters

Parameter Type Required Description
uuid string UUID of the user account. This parameter is required unless you are using either the id parameter or the key_attribute parameter.
id string ID of the user account. This parameter is required unless you are using either the uuid parameter or the key_attribute parameter.
key_attribute string Unique attribute found in the user account schema. This parameter is required unless you are using either the id parameter or the uuid parameter.
key_value string Value assigned to the key_attribute parameter.
redirect_uri string Token exchange URL.
type_name string Yes Name of the entityType.
transaction_state string JSON object that will be associated with the authorization code and returned when it is exchanged for an access_token and a refresh token. You determine what data is returned.
lifetime string Number of seconds for which the code is valid. The default is 30 seconds.
for_client_id string Yes Client ID of the API client being used to retrieve an authorization code.


200 OK

Response Example (application/json)

  "authorizationCode": "12345678912345",
  "stat": "ok"