---
title: "Authorize endpoint"
url: "https://earlyaccess.developers.bynder.com/apis/o-auth-20-1/versions/09a25bc1-038b-40be-a677-10c314a6ec04/paths/v6-authentication-oauth2-auth/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/o-auth-20-1/versions/09a25bc1-038b-40be-a677-10c314a6ec04.md

# Authorize endpoint

`GET` `/v6/authentication/oauth2/auth`

When using the Authorization Code grant, redirect the user to the Authorize application endpoint. After the user is authenticated and approves the authorization request, Bynder will redirect the user back with an authorization code which can then be passed to the Token endpoint.

## Query parameters

- `client_id` (string, required)
- `scope` (string, required)
- `redirect_uri` (string, required)
- `response_type` (string, required)
- `state` (string, optional)

## Responses

- `302` - Found. Redirecting to the login provider.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: OAuth 2.0
  version: 1.0.0
paths:
  /v6/authentication/oauth2/auth:
    get:
      description: >
        When using the Authorization Code grant, redirect the user to the
        Authorize application endpoint. After the user is authenticated and
        approves the authorization request, Bynder will redirect the user back
        with an authorization code which can then be passed to the Token
        endpoint.
      parameters:
        - example: 00000000-0000-0000-0000-000000000000
          in: query
          name: client_id
          required: true
          schema:
            type: string
        - example: offline asset:read
          in: query
          name: scope
          required: true
          schema:
            type: string
        - example: https://localhost/callback
          in: query
          name: redirect_uri
          required: true
          schema:
            type: string
        - example: code
          in: query
          name: response_type
          required: true
          schema:
            type: string
        - example: xyz
          in: query
          name: state
          required: false
          schema:
            type: string
      responses:
        "302":
          content:
            text/plain:
              examples:
                example-1:
                  value: Found. Redirecting to
                    https://your-bynder-domain/v6/login-provider/login?login_challenge=8e41a26ceb3b845114b5a37d9d0e2e50
          description: Found. Redirecting to the login provider.
          headers:
            Location:
              description: URL to redirect the user to for login.
              schema:
                type: string
      security:
        - OAuth2: []
      summary: Authorize endpoint
      tags:
        - Authorize endpoint
security:
  - OAuth2: []
```