--- updatedAt: 2026-04-29T15:21:37.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/mfa-oidc/llms.txt --- # Get an authorization code This operation authenticates and authorizes the user. You need to make this request from the browser. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Akamai MFA OIDC API", "url": "https://techdocs.akamai.com/mfa-oidc/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Akamai MFA OIDC", "version": "v1" }, "openapi": "3.0.0", "paths": { "/authorize": { "get": { "description": "This operation authenticates and authorizes the user. You need to make this request from the browser.", "externalDocs": { "description": "See documentation for this operation in Akamai's Akamai MFA OIDC API", "url": "https://techdocs.akamai.com/mfa-oidc/reference/get-authorize" }, "operationId": "get-authorize", "parameters": [ { "description": "A one-time use reference to the stored authorization request.", "in": "query", "name": "request_uri", "schema": { "example": "urn:ietf:params:oauth:request_uri:{}", "type": "string" }, "x-akamai": { "file-path": "parameters/request-uri.yaml" } }, { "description": "The integration identifier for your Akamai MFA OIDC integration.", "in": "query", "name": "client_id", "schema": { "example": "app_9FKZDPoagtw8vjNVY2m3aR", "type": "string" }, "x-akamai": { "file-path": "parameters/client-id.yaml" } } ], "responses": { "302": { "content": {}, "description": "After successful authentication, the browser is redirected to the callback URL stored in the authorization request.", "headers": { "Location": { "description": "Callback URL to redirect to. The query parameters `code` and `state` are appended to the URL.", "example": "https://mfa.callback.com/?code=&state=", "schema": { "format": "uri", "type": "string" } } } }, "400": { "content": { "application/problem+json": { "example": { "error": "JSON Deserialization failure: 'missing field `response_type` at line 9 column 1", "support_id": "abf01d28-a339-49b4-90c9-914862c88fb1" }, "schema": { "additionalProperties": true, "description": "Error response from Akamai MFA OIDC.", "properties": { "error": { "description": "A short description of the error that occurred. Intended to help the client understand what went wrong.", "minLength": 1, "type": "string" }, "support_id": { "description": "The support ID can help trace the cause of the error.", "minLength": 1, "type": "string" } }, "required": [ "error", "support_id" ], "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Bad request](https://techdocs.akamai.com/mfa-oidc/reference/400). The server couldn’t process the request due to malformed or missing parameters." }, "401": { "content": { "application/problem+json": { "example": { "error": "PAR authentication could not be verified.", "support_id": "abf01d28-a339-49b4-90c9-914862c88fb1" }, "schema": { "additionalProperties": true, "description": "Error response from Akamai MFA OIDC.", "properties": { "error": { "description": "A short description of the error that occurred. Intended to help the client understand what went wrong.", "minLength": 1, "type": "string" }, "support_id": { "description": "The support ID can help trace the cause of the error.", "minLength": 1, "type": "string" } }, "required": [ "error", "support_id" ], "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Unauthorized](https://techdocs.akamai.com/mfa-oidc/reference/401). Integration ID is invalid or missing." }, "403": { "content": { "application/problem+json": { "example": { "error": "Application lacks API permissions.", "support_id": "abf01d28-a339-49b4-90c9-914862c88fb1" }, "schema": { "additionalProperties": true, "description": "Error response from Akamai MFA OIDC.", "properties": { "error": { "description": "A short description of the error that occurred. Intended to help the client understand what went wrong.", "minLength": 1, "type": "string" }, "support_id": { "description": "The support ID can help trace the cause of the error.", "minLength": 1, "type": "string" } }, "required": [ "error", "support_id" ], "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Forbidden](https://techdocs.akamai.com/mfa-oidc/reference/403). The server understood the request but refused to process it." }, "404": { "content": { "application/problem+json": { "example": { "error": "Resource could not be found.", "support_id": "abf01d28-a339-49b4-90c9-914862c88fb1" }, "schema": { "additionalProperties": true, "description": "Error response from Akamai MFA OIDC.", "properties": { "error": { "description": "A short description of the error that occurred. Intended to help the client understand what went wrong.", "minLength": 1, "type": "string" }, "support_id": { "description": "The support ID can help trace the cause of the error.", "minLength": 1, "type": "string" } }, "required": [ "error", "support_id" ], "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Not found](https://techdocs.akamai.com/mfa-oidc/reference/404). Requested resource not found." }, "415": { "content": { "application/problem+json": { "example": { "error": "Unsupported media type.", "support_id": "abf01d28-a339-49b4-90c9-914862c88fb1" }, "schema": { "additionalProperties": true, "description": "Error response from Akamai MFA OIDC.", "properties": { "error": { "description": "A short description of the error that occurred. Intended to help the client understand what went wrong.", "minLength": 1, "type": "string" }, "support_id": { "description": "The support ID can help trace the cause of the error.", "minLength": 1, "type": "string" } }, "required": [ "error", "support_id" ], "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Unsupported media type](https://techdocs.akamai.com/mfa-oidc/reference/415). Content type not supported." }, "500": { "content": { "application/problem+json": { "example": { "error": "Something went wrong.", "support_id": "abf01d28-a339-49b4-90c9-914862c88fb1" }, "schema": { "additionalProperties": true, "description": "Error response from Akamai MFA OIDC.", "properties": { "error": { "description": "A short description of the error that occurred. Intended to help the client understand what went wrong.", "minLength": 1, "type": "string" }, "support_id": { "description": "The support ID can help trace the cause of the error.", "minLength": 1, "type": "string" } }, "required": [ "error", "support_id" ], "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Internal server error](https://techdocs.akamai.com/mfa-oidc/reference/500). Unexpected error occurred on the server." } }, "summary": "Get an authorization code", "tags": [ "Pushed Authorization Requests" ] }, "x-akamai": { "file-path": "paths/authorize.yaml", "path-info": "/authorize" } } }, "servers": [ { "url": "https://mfa.akamai.com/api/v1/idp/oidc" } ], "x-akamai": { "auth-type": "OAUTH", "file-path": "01-par.yaml" }, "x-readme": { "samples-languages": [ "curl", "python", "node" ], "explorer-enabled": true, "proxy-enabled": true } } ``` # Sibling pages * [Submit an authorization request](https://techdocs.akamai.com/mfa-oidc/reference/post-par.md) * [Create an ID token](https://techdocs.akamai.com/mfa-oidc/reference/post-token.md)