openapi: 3.1.0
info:
  title: Interzoid City Data Standardization API
  description: This API provides a standard for US and international cities for the purposes of standardizing city name data, improving query results, analytics, and data merging.
  contact:
    name: API Support
    url: https://www.interzoid.com
    email: support@interzoid.com
  version: '1.0.0'
jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema
servers:
- url: https://api.interzoid.com
  variables: {}
paths:
  /getcitystandard:
    get:
      tags:
      - City Data Standardization
      summary: getcitystandard
      description: Gets a pre-selected city name standard for US and international cities for various permutations of a given city name.
      operationId: getcitystandard
      parameters:
      - name: license
        in: query
        description: Your Interzoid license API key. Register at www.interzoid.com/register-api-account
        required: true
        style: form
        explode: true
        schema:
          type: string
      - name: city
        in: query
        description: City name from which to retrieve the standardized version
        required: true
        style: form
        explode: true
        schema:
          type: string
      responses:
        '200':
          description: Standardized city name data
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetcitystandardResponse'
        '400':
          description: bad request - insufficient parameters
          headers: {}
          content: {}
        '402':
          description: credits exhausted
          headers: {}
          content: {}
        '403':
          description: invalid license API key
          headers: {}
          content: {}
        '405':
          description: method not allowed
          headers: {}
          content: {}
        '500':
          description: internal server error
          headers: {}
          content: {}
      deprecated: false
    parameters: []
components:
  schemas:
    GetcitystandardResponse:
      title: GetcitystandardResponse
      type: object
      properties:
        CityStandard:
          type: string
        Code:
          type: string
        Credits:
          type: string
tags:
- name: City Data Standardization
  description: ''
externalDocs:
  description: API home page and documentation
  url: https://www.interzoid.com/apis/standardize-city-data