MatchingCriteria

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/yelp/json-schema/yelp-matching-criteria-schema.json",
  "title": "MatchingCriteria",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/yelp-claim-business-api-openapi.yml#/components/schemas/MatchingCriteria",
  "type": "object",
  "properties": {
    "address1": {
      "type": "string",
      "description": "The first line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.': are allowed.\n"
    },
    "address2": {
      "type": "string",
      "description": "The second line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.': are allowed.\n"
    },
    "address3": {
      "type": "string",
      "description": "The third line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.': are allowed.\n"
    },
    "city": {
      "type": "string",
      "description": "The city of the business. Maximum length is 64; only digits, letters, spaces, and _-’.() are allowed.\n"
    },
    "country": {
      "type": "string",
      "description": "The ISO 3166-1 alpha-2 country code of the business. Maximum length is 2.\n"
    },
    "latitude": {
      "type": "number",
      "description": "The WGS84 latitude of the business in decimal degrees. Must be between -90 and 90.\n"
    },
    "longitude": {
      "type": "number",
      "description": "The WGS84 longitude of the business in decimal degrees. Must be between -180 and 180.\n"
    },
    "name": {
      "type": "string",
      "description": "The name of the business. Maximum length is 64; only digits, letters, spaces, and _!#$%&+,-.’/:?@' are allowed.\n"
    },
    "phone": {
      "type": "string",
      "description": "The phone number of the business, either (a) locally-formatted with digits only (e.g., 016703080) or (b) internationally-formatted with a leading + sign and digits only after (+35316703080). Maximum length is 32.\n"
    },
    "postal_code": {
      "type": "string",
      "description": "The postal code of the business. Maximum length is 12.\n"
    },
    "state": {
      "type": "string",
      "description": "The ISO 3166-2 code for the region/province of the business. Maximum length is 3.\n"
    },
    "yelp_business_id": {
      "type": "string",
      "description": "Unique Yelp identifier of the business if available. Used as a hint when finding a matching business.\n"
    }
  },
  "required": [
    "city",
    "country",
    "name",
    "postal_code",
    "state"
  ]
}