Quinyx Authentication API

The Authentication API from Quinyx — 2 operation(s) for authentication.

Operations 2

POST /v2/oauth/token Issue access token #
POST /oauth/token Get new access and refresh token #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/quinyx-authentication-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

quinyx-authentication-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Quinyx Authentication API
  version: v2
  x-refined-note:
  - x-service differs across the merged source definitions and was not carried
  description: 'Operations tagged Authentication across 2 of this provider''s published API definitions: quinyx-api-v2-openapi.yml, quinyx-userapi-v2-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.quinyx.com
  description: Production API
- url: https://api-rc.quinyx.com
  description: RC API
- url: https://user-api.quinyx.com/v2
  description: Production API
- url: https://user-api-rc.quinyx.com/v2
  description: RC API
tags:
- name: Authentication
  x-displayName: Authentication
paths:
  /v2/oauth/token:
    post:
      tags:
      - Authentication
      summary: Issue access token
      description: Operation returns the security token to be used for subsequent calls to API
      operationId: authenticated
      parameters:
      - name: grant_type
        in: query
        description: Grant type requested
        required: true
        schema:
          type: string
        example: client_credentials
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rest-api-uaa_OAuth2Token'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rest-api-uaa_OAuth2Token'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rest-api-uaa_OAuth2Token'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rest-api-uaa_OAuth2Token'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rest-api-uaa_OAuth2Token'
      x-audience: public
    servers:
    - url: https://api.quinyx.com
      description: Production API
    - url: https://api-rc.quinyx.com
      description: RC API
  /oauth/token:
    post:
      tags:
      - Authentication
      summary: Get new access and refresh token
      description: To get tokens using your login credentials you will need to set 'grantType' to 'password' and send it together with the 'username' and 'password'. To get tokens using refresh token you will need to set 'grantType' to 'refresh_token' and sent it together with the 'refreshToken'.
      operationId: 55a51a4de1b282bc0fbf6e49f7560071
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
              - grantType
              properties:
                grantType:
                  type: string
                  enum:
                  - password
                  - refresh_token
                  example: password
                refreshToken:
                  type: string
                  example: SomeRandomStringThatRepresentsRefreshToken
                username:
                  description: Employee email address
                  type: string
                  example: foo@example.com
                password:
                  type: string
                  example: someRandomPassword
              type: object
      responses:
        '200':
          description: Tokens are successfully created. Copy 'accessToken' and add it to 'Authorization' header in format 'Bearer accessToken'. Access token will expire in 15 minutes so use received 'refreshToken' to generate new tokens
          content:
            application/json:
              schema:
                properties:
                  token:
                    $ref: '#/components/schemas/TokenResponse'
                type: object
        '400':
          description: Error while getting tokens.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Error while getting tokens.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidUsernamePassword'
      x-audience: public
    servers:
    - url: https://user-api.quinyx.com/v2
      description: Production API
    - url: https://user-api-rc.quinyx.com/v2
      description: RC API
components:
  schemas:
    rest-api-uaa_OAuth2Token:
      type: object
      properties:
        expires_in:
          type: integer
          format: int64
          example: 3600
        jti:
          type: string
          example: 550e8400-e29b-41d4-a716-446655440000
        access_token:
          type: string
          example: eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjbGllbnQifQ.signature
        scope:
          type: string
          example: read write
        token_type:
          type: string
          example: bearer
    TokenResponse:
      description: Token object
      properties:
        tokenType:
          description: Token type. It is always Bearer.
          type: string
          enum:
          - Bearer
          example: Bearer
        accessToken:
          description: Access token used for authorization. Copy it to 'Authorization' header in format 'Bearer accessToken'
          type: string
          example: receivedAccessToken
        expiredIn:
          description: Expiration time for access tokens in seconds, default is 900.
          type: integer
          example: 900
        refreshToken:
          description: Refresh token used for getting new access token. It will expire in 30 days.
          type: string
          example: receivedRefreshToken
      type: object
    ErrorResponse:
      properties:
        err:
          properties:
            code:
              type: integer
              example: 400
            msg:
              type: string
              example: SOME_ERROR_MESSAGE
          type: object
      type: object
    InvalidUsernamePassword:
      properties:
        err:
          properties:
            code:
              type: integer
              example: 401
            msg:
              type: string
              example: INVALID_USERNAME_OR_PASSWORD
          type: object
      type: object
  securitySchemes:
    employee_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes:
            hr:employees:create: ''
            hr:employees:delete: ''
            hr:employees:read: ''
            hr:employees:update: ''
    opening-hours_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes: {}
    organisation_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes:
            organization:groups:create: ''
            organization:groups:delete: ''
            organization:groups:read: ''
            organization:groups:update: ''
    rest-api-uaa_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes: {}
    schedule-availability_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes: {}
    schedule_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes: {}
    statistics_OAuth2ClientCredentials:
      type: oauth2
      description: OAuth2 Client Credentials flow. See https://developer.quinyx.com/api/authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth/v3/token
          scopes: {}
    BearerAuth:
      type: apiKey
      in: header
      name: Authorization
x-refined-from:
- quinyx-api-v2-openapi.yml
- quinyx-userapi-v2-openapi.yml