---
title: "authorize (Authorization Code)"
url: "https://developer.pxg.konera.com/apis/number-verification-v1/versions/1554527f-4237-4b00-a8d4-a6b8d30bda00/operations/auth-v1_authorize"
---

> Full API specification: https://developer.pxg.konera.com/apis/number-verification-v1/versions/1554527f-4237-4b00-a8d4-a6b8d30bda00.md

# authorize (Authorization Code)

`GET` `/api/auth/v1/authorize`

Operation ID: `auth-v1_authorize`

OAuth 2.0 / OpenID Connect authorization endpoint for Number Verification v1. Returns **302 Found** redirecting the user-agent to the Operator Authorization Server.

## Query parameters

- `response_type` (string, required)
- `scope` (string, required)
- `client_id` (string, required)
- `login_hint` (string, optional)
- `state` (string, optional)
- `redirect_uri` (string, uri, required)
- `prompt` (string, optional)
- `konera_context` (string, optional)

## Responses

- `302` - Redirect to Operator Authorization Server.
- `400` - Bad request
- `429` - Too Many Requests
- `500` - Internal server error
- `503` - Service unavailable

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Number Verification API
  version: 1.0.0
servers:
  - url: https://api.pxg.konera.com/camara
    description: Production CAMARA API Gateway
paths:
  /api/auth/v1/authorize:
    get:
      tags:
        - Number Verification V1
      summary: authorize (Authorization Code)
      operationId: auth-v1_authorize
      description: OAuth 2.0 / OpenID Connect authorization endpoint for Number
        Verification v1. Returns **302 Found** redirecting the user-agent to the
        Operator Authorization Server.
      security: []
      parameters:
        - name: response_type
          in: query
          required: true
          schema:
            type: string
            example: code
        - name: scope
          in: query
          required: true
          schema:
            type: string
            example: openid dpv:FraudPreventionAndDetection number-verification:verify
              offline_access
        - name: client_id
          in: query
          required: true
          schema:
            type: string
        - name: login_hint
          in: query
          required: false
          schema:
            type: string
            description: Login hint, e.g., tel:+34666666666 (URL-encoded when used).
        - name: state
          in: query
          required: false
          schema:
            type: string
        - name: redirect_uri
          in: query
          required: true
          schema:
            type: string
            format: uri
        - name: prompt
          in: query
          required: false
          schema:
            type: string
            example: none
        - name: konera_context
          in: query
          required: false
          schema:
            type: string
            description: Optional Konera context, typically containing ipv4/ipv6 hints
              (URL-encoded), e.g. ipv4:142.115.147.143,ipv6:2001:4860:7:f04::fe
      responses:
        "302":
          description: Redirect to Operator Authorization Server.
          headers:
            Location:
              description: Operator authorization URL.
              schema:
                type: string
                format: uri
        "400":
          $ref: "#/components/responses/BadRequest"
        "429":
          $ref: "#/components/responses/TooManyRequests"
        "500":
          $ref: "#/components/responses/InternalServerError"
        "503":
          $ref: "#/components/responses/ServiceUnavailable"
security: []
components:
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Error"
    TooManyRequests:
      description: Too Many Requests
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Error"
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Error"
    ServiceUnavailable:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Error"
  schemas:
    Error:
      type: object
      required:
        - status
        - code
        - message
      properties:
        status:
          type: integer
          example: 400
        code:
          type: string
          example: INVALID_ARGUMENT
        message:
          type: string
          example: Invalid request
```