International Trade Administration · API Governance Rules

International Trade Administration API Rules

Spectral linting rules defining API design standards and conventions for International Trade Administration.

0 Rules
View Rules File View on GitHub

Spectral Ruleset

Raw ↑
x-aid: international-trade-administration:international-trade-administration-rules
x-name: International Trade Administration API Rules
description: >-
  Operational and governance rules for consuming the International Trade
  Administration Data Services Platform APIs. These rules describe
  authentication, rate limiting, terms of service, and acceptable use
  expectations defined by ITA.
x-url: >-
  https://raw.githubusercontent.com/api-evangelist/international-trade-administration/refs/heads/main/openapi/international-trade-administration-rules.yml
x-modified: '2026-04-28'
x-specificationVersion: '0.19'
rules:
  - name: Subscription Key Required
    description: >-
      All requests must include a valid Ocp-Apim-Subscription-Key header
      issued through the developer.trade.gov portal.
    type: Authentication
    enforcement: Required
  - name: Terms of Service Acceptance
    description: >-
      Consumers must accept the ITA Data Services Terms of Service prior
      to using the APIs in production.
    type: Legal
    enforcement: Required
    url: https://developer.trade.gov/terms-of-service
  - name: Service Level Agreement
    description: >-
      ITA targets best-effort availability for its data services and
      publishes incident notices through the developer portal.
    type: SLA
    enforcement: Advisory
    url: https://developer.trade.gov/service-level-agreement
  - name: Attribution
    description: >-
      Applications consuming ITA data should attribute the International
      Trade Administration as the source.
    type: Attribution
    enforcement: Recommended
  - name: Acceptable Use
    description: >-
      ITA APIs are made available for lawful trade-promotion and
      compliance purposes. Bulk scraping, redistribution as a competing
      service, or use that violates U.S. export law is prohibited.
    type: Acceptable Use
    enforcement: Required
  - name: Rate Limiting
    description: >-
      Default subscription tiers throttle requests; high-volume consumers
      should request elevated quotas through DataServices@trade.gov.
    type: Rate Limiting
    enforcement: Required
  - name: Data Freshness
    description: >-
      Source list update cadences vary by dataset; the screening list
      sources endpoint exposes per-source last-imported and last-updated
      timestamps.
    type: Data Quality
    enforcement: Advisory
x-contact:
  - FN: ITA Data Services
    email: DataServices@trade.gov
    url: https://developer.trade.gov