.wpb_animate_when_almost_visible { opacity: 1; }
User Details France
Enrich your service with user profile information.

The User Details France API gives you qualified information for customers authenticating on your service through the Orange Authentication API. You will need the end-user's consent in order to access his information. A dedicated UI is provided with the API.

Before starting

User Details France API requires a 3-legged authentication with our OpenID Connect platform. Please follow the method described here with the scope profile_limited to get an access token.

Retrieve user data

You can now use the access token to invoke the User Details France API. The access token must be provided in the HTTP Authorization header :

curl -X GET \
     -H "Authorization: Bearer OFR-948ef...d5de1f4" \
     https://api.orange.com/userdetails/fr/v2/userinfo/

This request returns JSON data containing information about the authenticated user :

{ "sub": "248289761001", "name": "Jane Doe" }

The sub field contains a unique and persistent user identifier, specific to your application. The name field contains the declarative display name of the end-user.

Exemples :

Once the authorization code is obtained

curl -X GET -H "Authorization: Bearer OFR-948ef...d5de1f4" 
"https://api.orange.com/userdetails/fr/v2/userinfo"
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache

{
  "sub": "248289761001", "name": "Jane Doe"
}

In case of error, you will receive a specific response. Following, an example of error :

HTTP/1.1 401 Unauthorized
WWW-Authenticate: error="invalid_token", error_description="The Access Token expired"

In these error cases, a new access token must be requested again starting from the "requesting authorization code" step or by using a refresh token.

In case the end-user has not consented to the use of his resources, the error will be :

HTTP/1.1 403 Forbidden
Content-Type:application/json

{
  "error": "insufficient_scope", "error_description": "No user info scope was authorized"
}