Interzoid Data Standardization API

openapi: 3.2.0
info:
  contact:
    email: support@interzoid.com
    name: Interzoid Support
    url: https://www.interzoid.com
  description: AI-powered data quality, data matching, data standardization, and data enrichment APIs. Pay per call with USDC via the x402 protocol, or use an Interzoid API key.
  termsOfService: https://www.interzoid.com/api-terms-use
  title: Interzoid Data Quality and Enrichment Data Standardization…
  version: 2.0.0
  x-guidance: 'All endpoints are HTTP GET with query string parameters and return JSON. Two ways to call: (1) include an Interzoid API key in the x-api-key header, or (2) send no key to receive an HTTP 402 x402 payment challenge, pay the quoted amount in USDC on Base (eip155:8453), and retry with the Payment-Signature header. Prices are per call and listed in each operation''s x-payment-info. Matching endpoints return a SimKey similarity key: two inputs that produce the same SimKey refer to the same real-world entity, so generate keys for your records and group on them to find matches and duplicates. Score endpoints return a 0-100 match confidence for a pair of inputs. Standardization endpoints return canonical forms, and enrichment endpoints return structured data about the input entity. Premium enrichment endpoints take an optional language parameter (a code or name such as de or German) and return their result values in that language at the same price; it is listed in each operation''s parameters. A successful response includes Code: Success.'
servers:
- url: https://api.interzoid.com
tags:
- name: data-standardization
paths:
  /getcitystandard:
    get:
      operationId: getcitystandard
      parameters:
      - description: City name to standardize
        example: San Fran
        in: query
        name: city
        required: true
        schema:
          type: string
      - description: State or Province (optional but recommended)
        example: CA
        in: query
        name: state
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                CityStandard: San Francisco
                Code: Success
                Credits: '0'
          description: Successful response
        '400':
          description: Missing or invalid parameters
        '402':
          description: Payment Required. Returns an x402 challenge with payment requirements in the Payment-Required header and JSON body.
      security:
      - ApiKeyAuth: []
      - {}
      summary: 'City name standardization: converts abbreviations, nicknames, alternate…'
      tags:
      - data-standardization
      x-payment-info:
        price:
          amount: '0.01'
          currency: USD
          mode: fixed
        protocols:
        - x402
      x-search-tags:
      - city name standardization
      - address cleansing
      - data quality
      - geocoding
      - location data
  /getcountryinfo:
    get:
      operationId: getcountryinfo
      parameters:
      - description: Country name (in any language or format)
        example: Deutschland
        in: query
        name: country
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                CallingCode: '+49'
                Code: Success
                CountryStandard: Germany
                Credits: '0'
                CurrencyCode: EUR
                CurrencyName: Euro
                CurrencySubUnit: cent
                CurrencySymbol: €
                InternetCode: .de
                ThreeDigitCode: '276'
                ThreeLetterCode: DEU
                TwoLetterCode: DE
          description: Successful response
        '400':
          description: Missing or invalid parameters
        '402':
          description: Payment Required. Returns an x402 challenge with payment requirements in the Payment-Required header and JSON body.
      security:
      - ApiKeyAuth: []
      - {}
      summary: 'Country data lookup: standardizes a country name given in any language or…'
      tags:
      - data-standardization
      x-payment-info:
        price:
          amount: '0.01'
          currency: USD
          mode: fixed
        protocols:
        - x402
      x-search-tags:
      - country codes
      - ISO country codes
      - currency codes
      - calling codes
      - country data
  /getcountrystandard:
    get:
      operationId: getcountrystandard
      parameters:
      - description: Country name to standardize
        example: uae
        in: query
        name: country
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                Code: Success
                CountryStandard: United Arab Emirates
                Credits: '0'
          description: Successful response
        '400':
          description: Missing or invalid parameters
        '402':
          description: Payment Required. Returns an x402 challenge with payment requirements in the Payment-Required header and JSON body.
      security:
      - ApiKeyAuth: []
      - {}
      summary: 'Country name standardization: converts any country name variation (''UK'', ''Great…'
      tags:
      - data-standardization
      x-payment-info:
        price:
          amount: '0.01'
          currency: USD
          mode: fixed
        protocols:
        - x402
      x-search-tags:
      - country name standardization
      - data cleansing
      - address normalization
      - data quality
      - country lookup
  /getorgstandard:
    get:
      operationId: getorgstandard
      parameters:
      - description: Organization name to standardize
        example: Gen Electric Corp
        in: query
        name: org
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                Code: Success
                Credits: '0'
                Standard: General Electric
          description: Successful response
        '400':
          description: Missing or invalid parameters
        '402':
          description: Payment Required. Returns an x402 challenge with payment requirements in the Payment-Required header and JSON body.
      security:
      - ApiKeyAuth: []
      - {}
      summary: 'Company name standardization: converts an organization name to its standard…'
      tags:
      - data-standardization
      x-payment-info:
        price:
          amount: '0.01'
          currency: USD
          mode: fixed
        protocols:
        - x402
      x-search-tags:
      - company name standardization
      - data cleansing
      - CRM data quality
      - master data management
      - deduplication
  /getstateabbreviation:
    get:
      operationId: getstateabbreviation
      parameters:
      - description: State or province name/abbreviation to standardize
        example: Calif
        in: query
        name: state
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                Abbreviation: CA
                Code: Success
                Credits: '0'
                State: California
          description: Successful response
        '400':
          description: Missing or invalid parameters
        '402':
          description: Payment Required. Returns an x402 challenge with payment requirements in the Payment-Required header and JSON body.
      security:
      - ApiKeyAuth: []
      - {}
      summary: 'US state and province standardization: converts variations such as ''Calif''…'
      tags:
      - data-standardization
      x-payment-info:
        price:
          amount: '0.01'
          currency: USD
          mode: fixed
        protocols:
        - x402
      x-search-tags:
      - state abbreviation
      - state name standardization
      - address cleansing
      - data quality
      - US states
components:
  securitySchemes:
    ApiKeyAuth:
      description: Interzoid API key. Omit to receive an x402 payment challenge instead.
      in: header
      name: x-api-key
      type: apiKey