> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywise.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Get partner token info

> Return non-PII metadata about the calling partner token: its id, name, scopes, capabilities and the owning partner. It never returns the owner's email or name.



## OpenAPI

````yaml /api-docs/partner-api/openapi.json get /partner/v2/info/
openapi: 3.0.3
info:
  description: >-
    Onboard and manage companies and their memberships through the current API
    at the `/partner/v2/` HTTP path.
  title: paywise Partner API
  version: current
servers:
  - description: Production environment
    url: https://api.paywise.de
  - description: Sandbox environment
    url: https://api-sandbox.paywise.de
security: []
tags:
  - description: Client companies managed by the partner.
    name: Companies
  - description: Memberships and invitations of a managed company.
    name: Company users
  - description: Webhook endpoints and their signing secrets.
    name: Webhooks
  - description: Delivery log and redelivery of webhook events.
    name: Webhook deliveries
  - description: Ordered feed of the events webhooks deliver.
    name: Events
  - description: Reference catalog of legal forms.
    name: Legal forms
  - description: The authenticated credential and API availability.
    name: Meta
  - description: Rate-limit headroom of the credential.
    name: Usage
externalDocs:
  url: https://docs.paywise.de/api-docs/partner-api/introduction
paths:
  /partner/v2/info/:
    get:
      tags:
        - Meta
      summary: Get partner token info
      description: >-
        Return non-PII metadata about the calling partner token: its id, name,
        scopes, capabilities and the owning partner. It never returns the
        owner's email or name.
      operationId: get-partner-token-info
      parameters: []
      responses:
        '200':
          content:
            application/json:
              examples:
                TokenInfo:
                  summary: Token info
                  value:
                    capabilities:
                      - USER_ACCESS_REVOCATION
                    environment: production
                    id: 14000000-0000-4000-8000-000000000001
                    partner:
                      id: 11000000-0000-4000-8000-000000000001
                      name: Example Platform
                    scopes:
                      - partner:companies:read
                      - partner:companies:write
                      - partner:users:write
                    token_name: Onboarding integration
              schema:
                $ref: '#/components/schemas/PartnerTokenInfoResponse'
          description: ''
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '401':
          content:
            application/json:
              examples:
                authentication-error:
                  value:
                    code: not_authenticated
                    detail: Authentication credentials were not provided.
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            Retry-After:
              description: Integer seconds to wait before retrying a throttled request.
              schema:
                minimum: 1
                type: integer
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Standard error response.
          headers:
            Cache-Control:
              description: >-
                Cacheability directive. Authenticated responses use `private,
                no-store`; the legal-form catalog may use `private,
                max-age=86400`.
              schema:
                type: string
            X-Paywise-Environment:
              description: Environment that produced the response.
              schema:
                enum:
                  - production
                  - sandbox
                type: string
            X-Paywise-Request-Id:
              description: >-
                Fresh server-assigned correlation id for this response.
                Caller-provided request ids are ignored.
              schema:
                format: uuid
                type: string
      security:
        - partnerBearerAuth: []
components:
  schemas:
    PartnerTokenInfoResponse:
      properties:
        capabilities:
          description: >-
            Current capabilities enabled for the partner organization. These are
            separate from token scopes; a wildcard scope does not grant a
            Partner capability.
          items:
            $ref: '#/components/schemas/CapabilitiesEnum'
          type: array
        environment:
          allOf:
            - $ref: '#/components/schemas/EnvironmentEnum'
          description: |-
            Environment in which the credential is being used.

            * `production` - production
            * `sandbox` - sandbox
        id:
          description: Stable identifier of the calling credential, when available.
          format: uuid
          nullable: true
          type: string
        partner:
          allOf:
            - $ref: '#/components/schemas/PartnerTokenInfoPartner'
          description: Partner organization that owns the calling credential.
          nullable: true
        scopes:
          description: Permissions granted to the calling credential.
          items:
            type: string
          type: array
        token_name:
          description: Human-readable name assigned to the calling credential.
          nullable: true
          type: string
      required:
        - capabilities
        - environment
        - id
        - partner
        - scopes
        - token_name
      type: object
    Error:
      properties:
        code:
          description: Machine-readable error category.
          type: string
        detail:
          description: Short human-readable summary of the error.
          type: string
        errors:
          description: Field-level validation errors, when applicable.
          items:
            $ref: '#/components/schemas/ErrorItem'
          type: array
      required:
        - detail
        - code
      type: object
    CapabilitiesEnum:
      description: '* `USER_ACCESS_REVOCATION` - Revoke user access'
      enum:
        - USER_ACCESS_REVOCATION
      type: string
    EnvironmentEnum:
      description: |-
        * `production` - production
        * `sandbox` - sandbox
      enum:
        - production
        - sandbox
      type: string
    PartnerTokenInfoPartner:
      properties:
        id:
          description: Stable identifier of the partner organization.
          format: uuid
          type: string
        name:
          description: Display name of the partner organization.
          type: string
      required:
        - id
        - name
      type: object
    ErrorItem:
      properties:
        code:
          description: Machine-readable field error code.
          type: string
        field:
          description: >-
            Path to the field that caused the error, using dots for objects and
            brackets for list indexes, for example `claims[0].amount`; null for
            an error without a field path.
          nullable: true
          type: string
        message:
          description: Human-readable explanation of the field error.
          type: string
      required:
        - field
        - code
        - message
      type: object
  securitySchemes:
    partnerBearerAuth:
      description: >-
        Partner API Bearer key: `Authorization: Bearer <key>`. Keys are created
        only through authorized portal or staff flows.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.