How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

FusionAuth Oauth2 API

The Oauth2 API from FusionAuth — 7 operation(s) for oauth2.

FusionAuth Oauth2 API is one of 37 APIs that FusionAuth publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 8 operations across 7 paths, and defines 18 schemas. It is described by OpenAPI 3.2.0, at version 1.66.0.

Requests are made against 2 base URLs: http://localhost:9011, https://sandbox.fusionauth.io.

8 operations 7 paths 18 schemas 3 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.66.0
Base URL
https://sandbox.fusionauth.io
Authentication
API Key, HTTP Bearer
License
Apache2
Resource Areas
1

Authentication & Security 2

FusionAuth Oauth2 API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 8

Across 7 paths, the API surfaces 8 operations — 3 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Oauth2 8
POST
/oauth2/device/approve
Approve a device grant. OR Approve a device grant.
createDeviceApprove → 200default
GET
/oauth2/device/user-code
Retrieve a usercode that is part of an in-progress Device Authorization Grant. This API is useful if you want to build your own login workflow to complete a device grant. This request will require an…
retrieveDeviceUserCode → 200default
POST
/oauth2/device/user-code
Retrieve a usercode that is part of an in-progress Device Authorization Grant. This API is useful if you want to build your own login workflow to complete a device grant. OR Retrieve a usercode that…
createDeviceUserCode → 200default
GET
/oauth2/device/validate
Validates the end-user provided usercode from the user-interaction of the Device Authorization Grant. If you build your own activation form you should validate the user provided code prior to beginni…
retrieveDeviceValidate 2 params → 200default
POST
/oauth2/device_authorize
Start the Device Authorization flow using a request body OR Start the Device Authorization flow using form-encoded parameters
createDevice_authorize → 200default
POST
/oauth2/introspect
Inspect an access token issued as the result of the Client Credentials Grant. OR Inspect an access token issued as the result of the Client Credentials Grant. OR Inspect an access token issued as the…
createIntrospect → 200default
POST
/oauth2/token
Exchange User Credentials for a Token. If you will be using the Resource Owner Password Credential Grant, you will make a request to the Token endpoint to exchange the user’s email and password for a…
createToken → 200default
GET
/oauth2/userinfo
Call the UserInfo endpoint to retrieve User Claims from the access token issued by FusionAuth.
retrieveUserInfoFromAccessTokenWithId → 200default

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are IdentityProviderLink (11 properties), AccessToken (8 properties), OAuthError (7 properties), TwoFactorMethod (7 properties). Each schema is shown below with its type and property counts.

TokenType
string
Bearer Token type as defined by RFC 6750 . MAC Token type as referenced by RFC 6749 and Draft RFC on OAuth 2.0 Message Authentication Code (MAC) Tokens DPoP To…
OAuthErrorType
string
OAuthErrorReason
string
DeviceApprovalResponse
object
5 properties
IntrospectResponse
object
DeviceResponse
object
6 properties
Errors
object
Standard error domain object that can also be used as the response from an API call.
2 properties
IdentityProviderType
string
AuthenticatorConfiguration
object
3 properties
ZonedDateTime
integer
The number of milliseconds since the unix epoch: January 1, 1970 00:00:00 UTC. This value is always in UTC.
OAuthError
object
7 properties
DeviceInfo
object
5 properties
TOTPAlgorithm
string
AccessToken
object
8 properties
Error
object
Defines an error.
3 properties
TwoFactorMethod
object
7 properties
UserinfoResponse
object
IdentityProviderLink
object
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

fusionauth-oauth2-api-openapi.yml Raw ↑

Other APIs FusionAuth publishes across the network.

FusionAuth Api Key API
FusionAuth Application API
FusionAuth Connector API
FusionAuth Consent API
FusionAuth Email API
FusionAuth Entity API
FusionAuth Form API
FusionAuth Group API
FusionAuth Health API
FusionAuth Identity API
FusionAuth Identity Provider API
FusionAuth Integration API
Where this information came from

This is an independent, third-party profile of FusionAuth Oauth2 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.