openapi: 3.0.3
info:
  title: Texas Instruments Financial Product Information API
  description: 'The Texas Instruments Product Information API provides programmatic access to TI''s product catalog, including part details, parametric data, quality and reliability information. Two variants are available: the standard API (multiple endpoint calls, higher rate limit) and the orchestrated API (single endpoint call, lower rate limit). Authentication uses OAuth 2.0 client credentials flow.'
  version: '1.0'
  contact:
    name: Texas Instruments API Support
    url: https://api-portal.ti.com/support
  license:
    name: Proprietary
    url: https://www.ti.com/
servers:
- url: https://transact.ti.com/v1
  description: Production - TI Product Information API
security:
- OAuth2: []
tags:
- name: Product Information
  description: Product details and parametric data
paths:
  /products/{partNumber}:
    get:
      operationId: getProductInformation
      summary: Get Product Information
      description: 'Retrieves basic product details and parametric data for a specific TI part number. Part numbers containing /NOPB must be URL-encoded (/ becomes %2F). Daily rate limit: 3,000 calls.'
      tags:
      - Product Information
      parameters:
      - name: partNumber
        in: path
        required: true
        description: TI part number. URL-encode special characters (e.g., /NOPB becomes %2FNOPB).
        schema:
          type: string
        example: OPA1612AIDR
      responses:
        '200':
          description: Product information and parametric data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductInformation'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    Unauthorized:
      description: Invalid or missing authentication token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Part number not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    ProductInformation:
      type: object
      description: Basic product details and parametric data for a TI part number.
      properties:
        tiPartNumber:
          type: string
          description: TI part number (OPN)
        genericPartNumber:
          type: string
          description: Generic/base part number
        description:
          type: string
          description: Part description
        packageType:
          type: string
          description: Package type (e.g., SOIC, QFN)
        pinCount:
          type: integer
          description: Number of pins
        lifeCycle:
          type: string
          description: Product lifecycle status
        productFamily:
          type: string
          description: TI product family
        tiProductType:
          type: string
          description: TI product type category
        dataSheetUrl:
          type: string
          description: URL to the product datasheet
        productPageUrl:
          type: string
          description: URL to the TI product page
        parametricData:
          type: array
          description: Technical specifications and parameters
          items:
            $ref: '#/components/schemas/ParametricData'
    ParametricData:
      type: object
      description: Technical parametric specification for a TI part.
      properties:
        parameterName:
          type: string
          description: Parameter name (e.g., "Supply Voltage (Max)")
        value:
          type: string
          description: Parameter value
        unit:
          type: string
          description: Unit of measurement (e.g., V, MHz, mA)
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://transact.ti.com/v1/oauth/accesstoken
          scopes: {}
      description: OAuth 2.0 client credentials flow. Obtain access token using client_id and client_secret from your myTI developer account.
externalDocs:
  description: TI Product Information API Developer Portal
  url: https://www.ti.com/developer-api/product-information-api-suite/getting-started.html