Refresh Access Token

🚧

This endpoint is deprecated

Please use the Get Access Token v2 endpoint for exchanging a refresh token with an access token.

Request Headers

Content-Type: application/x-www-form-urlencoded

Response

Parameter NameDescription
access_tokenToken issued by the authorization server. The token will be 128 characters long. Tokens will be valid for the R2R api for 7 days.
expires_inSeconds until token expires.
expiration_timestampThe expiration time of the access token in ISO8601 format.
token_typeThe type of token issued. Default to ‘Bearer’

Error Scenarios

For the following error scenarios, Yelp will respond with an HTTP error with the following format for the response body:

{
    "error": {
        "id" : "<ERROR_CODE_ID>",
        "description": "<Human readable description.>",
        "http_code": "<http_code>"
    }
}
iddescriptionhttp_code
INVALID_REQUESTMissing a required parameter or includes an unsupported parameter.HTTPBadRequest (400)
CLIENT_NOT_FOUNDSupplied client ID does not exist.HTTPNotFound (404)
INVALID_CLIENTClient authentication failed due to unknown client, no client authentication included, or unsupported authentication method.HTTPUnauthorized (401)
UNAUTHORIZED_CLIENTThe authenticated client is not authorized to use this authorization grant type.HTTPBadRequest (400)
UNSUPPORTED_GRANT_TYPEThe authorization grant type is not supported by the authorization server.HTTPBadRequest (400)
TOKEN_NOT_FOUNDSupplied refresh token does not exist.HTTPNotFound (404)
INVALID_SCOPEThe request is unauthorized for the given scope.HTTPBadRequest (400)
INVALID_TOKENThe access token linked to this refresh token is expired, revoked, malformed, or invalid for other reasons.HTTPBadRequest (400)
Language