Teliax

Teliax Number Inventory Audit API

Three-phase inventory audit operations

Documentation GitHub OpenAPI

Operations 8

POST /v1/inventory/audit/{auditJobId}/reject Reject dry-run #

POST /v1/inventory/audit/{auditJobId}/commit Commit dry-run #

POST /v1/inventory/audit/start Start inventory audit #

GET /v1/inventory/audit/{auditJobId} Get audit status #

DELETE /v1/inventory/audit/{auditJobId} Cancel audit #

GET /v1/inventory/audit/{auditJobId}/diff Get diff summary #

GET /v1/inventory/audit/{auditJobId}/diff/download Download diff report #

GET /v1/inventory/audit/history Get audit history #

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/teliax:teliax-number-inventory-audit-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:
  title: Teliax Number Inventory Audit API
  version: v1
  contact:
    name: Ringer API Support
    url: https://ringer.tel
    email: api-support@ringer.tel
  description: 'Operations tagged Number Inventory Audit across 2 of this provider''s published API definitions: teliax-tniq-openapi.json, teliax-tniq-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.tniq.ringer.tel
  description: Production
- url: https://tniq-api.ringer.tel
  description: Production (legacy alias)
- url: https://staging-api.ringer.tel
  description: Staging
tags:
- name: Number Inventory Audit
  description: Three-phase inventory audit operations
paths:
  /v1/inventory/audit/{auditJobId}/reject:
    post:
      tags:
      - Number Inventory Audit
      summary: Reject dry-run
      description: Rejects staging data and cleans up
      operationId: rejectAudit
      parameters:
      - name: auditJobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
  /v1/inventory/audit/{auditJobId}/commit:
    post:
      tags:
      - Number Inventory Audit
      summary: Commit dry-run
      description: Commits staging data to live inventory tables
      operationId: commitAudit
      parameters:
      - name: auditJobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
  /v1/inventory/audit/start:
    post:
      tags:
      - Number Inventory Audit
      summary: Start inventory audit
      description: Initiates a three-phase inventory audit for the specified SPID
      operationId: startAudit
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartAuditRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
  /v1/inventory/audit/{auditJobId}:
    get:
      tags:
      - Number Inventory Audit
      summary: Get audit status
      description: Retrieves the current status and progress of an audit job
      operationId: getAuditStatus
      parameters:
      - name: auditJobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    delete:
      tags:
      - Number Inventory Audit
      summary: Cancel audit
      description: Cancels a running audit job
      operationId: cancelAudit
      parameters:
      - name: auditJobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
  /v1/inventory/audit/{auditJobId}/diff:
    get:
      tags:
      - Number Inventory Audit
      summary: Get diff summary
      description: Returns change summary between staging and live data
      operationId: getDiffSummary
      parameters:
      - name: auditJobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
  /v1/inventory/audit/{auditJobId}/diff/download:
    get:
      tags:
      - Number Inventory Audit
      summary: Download diff report
      description: Downloads a detailed Excel change report
      operationId: downloadDiffReport
      parameters:
      - name: auditJobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
  /v1/inventory/audit/history:
    get:
      tags:
      - Number Inventory Audit
      summary: Get audit history
      description: Retrieves recent audit history for a SPID
      operationId: getAuditHistory
      parameters:
      - name: spid
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          format: int32
          default: 10
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
    servers:
    - url: https://api.tniq.ringer.tel
      description: Production
    - url: https://tniq-api.ringer.tel
      description: Production (legacy alias)
    - url: https://staging-api.ringer.tel
      description: Staging
components:
  schemas:
    StartAuditRequest:
      required:
      - spid
      type: object
      properties:
        spid:
          pattern: ^[A-Z0-9]{4}$
          type: string
        phaseSelection:
          type: string
          enum:
          - ALL
          - PHASE_1_ONLY
          - PHASE_2_ONLY
          - PHASE_3_ONLY
        purgeInventoryFirst:
          type: boolean
        includeCnam:
          type: boolean
        autoCommit:
          type: boolean
  securitySchemes:
    bearerAuth:
      type: http
      description: 'Bearer token authentication. Pass your API token or user JWT in the Authorization header: Authorization: Bearer YOUR_TOKEN'
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- teliax-tniq-openapi.json
- teliax-tniq-openapi.yml