Token API errors

Below are errors you may encounter while using the Token API.

Obtain token errors

The response payload will resemble the following:

{
    "error": "invalid_request",
    "error_description": "Invalid or expired code parameter."
}

Response"error""error_description"Possible issue
400 Bad Requestinvalid_requestInvalid or expired code parameterThe code parameter retrieved during authentication is wrong, missing, or expired.
400 Bad Requestinvalid_requestredirect_uri did not match URI from initial requestThe redirect URI must be registered with Akoya
400 Bad Requestinvalid_grantMissing or incorrect grant_type field. Must be authorization_code
401 Unauthorizedinvalid_clientInvalid client credentials.The client id or secret is incorrect

Refresh token errors

The response payload will resemble the following:

{
    "error": "invalid_request",
    "error_description": "Invalid or expired code parameter."
}

Response"error""error_description"Possible issue
400 Bad Requestinvalid_requestNo refresh token in requestThe refresh token is missing, invalid, or claimed by another client
400 Bad Requestinvalid_requestRefresh token is invalid or has already been claimed by another client.The refresh token is wrong or expired
400 Bad Requestinvalid_grantMissing or incorrect grant_type field. Must be refresh_token
401 Unauthorizedinvalid_clientInvalid client credentials.The client id or secret is incorrect

Revoke token errors

The response payload will resemble the following:

{
    "error": "invalid_request"
}

Response"error"Possible issue
400 Bad Requestinvalid_requestOne or more key value is missing, invalid, or claimed by another client: refresh_token, client_id, client_secret
400 Bad Requestunsupported_token_typeThe token_type_hint must be set to refresh_token


Need help?

Check out our Developer Community, or visit the Support Center in the Data Recipient Hub.

Looking for provider nuance documentation?

All provider nuance documentation is available in the Data providers section in the Data Recipient Hub.

Still stuck?

For all production issues, submit a support ticket through the Data Recipient Hub. Our support team is standing by 24/7. Questions and non-production issues will be answered during business hours.