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/nfon-references-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  description: APIs for managing PBX configuration, tenants, operators, licenses, and related resources
  title: PBX Configuration References API
  version: 2026.07.20
servers:
- url: /configuration/v1
tags:
- x-displayName: References
  description: Find references to identifiers (extensions and service codes)
  name: references
paths:
  /tenants/{tenant}/references:
    get:
      summary: Find references to an identifier
      parameters:
      - schema:
          type: string
        required: true
        in: path
        description: ''
        name: tenant
      - schema:
          type: string
        required: true
        description: One or more identifiers to search for (comma-separated
        in: query
        examples:
          multiple:
            value: 100,200,*721234
            summary: Multiple identifiers
          single:
            value: '100'
            summary: Single identifier
        name: identifier
      - schema:
          type: boolean
        required: false
        in: query
        description: Controls the response structure. true (default) returns flat array
        name: flatten
      tags:
      - references
      description: Find all places where a given identifier (extension number or service code) is referenced within the tenant's configuration.
      operationId: findReferences
      security:
      - OAuth2:
        - tenant.admin
        - tenant.operator
        - tenant.system-integrator
        - tenant.manager
      responses:
        '404':
          content:
            application/json:
              examples:
                example:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: The requested resource was not found
                    code: not_found
                  summary: Not found
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            X-Request-Id:
              schema:
                format: uuid
                type: string
              description: Unique request identifier
          description: Not found
        '400':
          content:
            application/json:
              examples:
                example:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: Invalid request parameters
                    code: validation_error
                  summary: Validation error
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            X-Request-Id:
              schema:
                format: uuid
                type: string
              description: Unique request identifier
          description: Invalid request
        '401':
          content:
            application/json:
              examples:
                missingToken:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: JWT missing from the Authorization header.
                    code: authorization
                  summary: Missing token
                invalidToken:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: Invalid JWT in the Authorization header.
                    code: authorization
                  summary: Invalid token
                expiredToken:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: There was an issue validating your authorization token.
                    code: authorization
                  summary: Expired token
                accessingAnotherTenant:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: user is not allowed to perform actions in this access scope
                    code: authorization
                  summary: Accessing another Tenant
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            X-Request-Id:
              schema:
                format: uuid
                type: string
              description: Unique request identifier
          description: Unauthorized
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/References'
          headers:
            X-Request-Id:
              schema:
                format: uuid
                type: string
              description: Unique request identifier
          description: References found successfully
        '503':
          content:
            application/json:
              examples:
                example:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: The service is temporarily unavailable. Please try again later.
                    code: upstream_unavailable
                  summary: Service unavailable
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            X-Request-Id:
              schema:
                format: uuid
                type: string
              description: Unique request identifier
          description: Service temporarily unavailable
        '500':
          content:
            application/json:
              examples:
                example:
                  value:
                    request_id: 550e8400-e29b-41d4-a716-446655440000
                    message: Internal server error
                    code: internal_error
                  summary: Internal server error
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            X-Request-Id:
              schema:
                format: uuid
                type: string
              description: Unique request identifier
          description: Internal server error
components:
  schemas:
    Error:
      properties:
        request_id:
          type: string
          example: 550e8400-e29b-41d4-a716-446655440000
        code:
          type: string
          example: bad_request
        details:
          $ref: '#/components/schemas/ErrorDetail'
        message:
          type: string
          example: Invalid request
      type: object
      description: Error represents the standard API error response.
    HierarchicalReferences:
      properties:
        identifiers:
          items:
            $ref: '#/components/schemas/IdentifierReferences'
          type: array
      type: object
      required:
      - identifiers
      description: HierarchicalReferencesResponse represents references grouped by identifier. This is returned when flatten=false.
    IdentifierReferences:
      properties:
        references:
          items:
            $ref: '#/components/schemas/ReferenceItem'
          type: array
        identifier:
          type: string
      type: object
      required:
      - identifier
      - references
      description: IdentifierReferences groups references for a single identifier.
    References:
      oneOf:
      - $ref: '#/components/schemas/FlatReferences'
      - $ref: '#/components/schemas/HierarchicalReferences'
      description: 'FindReferencesResponse represents the response from the findReferences endpoint. The response structure depends on the ''flatten'' parameter: - flatten=true: FlatReferencesResponse (flat array with identifier field on each item) - flatten=false: HierarchicalReferencesResponse (grouped by identifier).'
    Data:
      properties:
        key:
          type: string
          description: Metadata key.
          example: function_key_number
        value:
          type: string
          description: Metadata value.
          example: '5'
      type: object
      required:
      - key
      - value
      description: Data represents key-value pair for additional reference metadata.
    FlatReferences:
      properties:
        references:
          items:
            $ref: '#/components/schemas/ReferenceItem'
          type: array
      type: object
      required:
      - references
      description: FlatReferencesResponse represents a flat array of references with identifier field on each item. This is returned when flatten=true (default).
    ReferenceType:
      type: string
      description: ReferenceType represents the type of entity that contains the reference.
    ReferenceItem:
      properties:
        fields:
          type: array
          items:
            $ref: '#/components/schemas/Field'
          description: List of fields within the entity that reference the identifier.
        identifier:
          type: string
          description: The identifier this reference is for (only present in flat response).
          example: '100'
        type:
          $ref: '#/components/schemas/ReferenceType'
        service_code:
          type: string
          description: Service code of the entity (if applicable).
          example: '*721234'
        extension_number:
          type: string
          description: Extension number of the entity (if applicable).
          example: '100'
        display_name:
          type: string
          description: Human-readable name of the entity containing the reference.
          example: John Doe
      type: object
      required:
      - type
      - display_name
      description: ReferenceItem represents a single reference to an identifier within the tenant's configuration.
    Field:
      properties:
        name:
          type: string
          description: Translation key or name of the field.
          example: phoneextension.callforward.busy
        data:
          type: array
          items:
            $ref: '#/components/schemas/Data'
          description: Additional metadata about the reference.
      type: object
      required:
      - name
      description: Field represents a field within an entity that references the identifier.
    ErrorDetail:
      properties:
        message:
          type: string
          example: Cannot delete license that is currently assigned to a user
        code:
          type: string
          example: license_assigned
      type: object
      description: ErrorDetail represents error details in the delete response.
  securitySchemes:
    jwt:
      scheme: bearer
      bearerFormat: JWT
      type: http