---
title: "Claim Business"
method: POST
path: "/v1/ingest/create"
tags: ["Claim Business"]
---

# Claim Business

`POST /v1/ingest/create`

SMB Claiming API provides a means to submit a business claim and to revoke a business claim on Yelp.

## Request body

- object
  - `matching_criteria` MatchingCriteria, required
    - `address1` string — The first line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.': are allowed.
    - `address2` string — The second line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.': are allowed.
    - `address3` string — The third line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.': are allowed.
    - `city` string, required — The city of the business. Maximum length is 64; only digits, letters, spaces, and _-’.() are allowed.
    - `country` string, required — The ISO 3166-1 alpha-2 country code of the business. Maximum length is 2.
    - `latitude` number — The WGS84 latitude of the business in decimal degrees. Must be between -90 and 90.
    - `longitude` number — The WGS84 longitude of the business in decimal degrees. Must be between -180 and 180.
    - `name` string, required — The name of the business. Maximum length is 64; only digits, letters, spaces, and _!#$%&+,-.’/:?@' are allowed.
    - `phone` string — 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.
    - `postal_code` string, required — The postal code of the business. Maximum length is 12.
    - `state` string, required — The ISO 3166-2 code for the region/province of the business. Maximum length is 3.
    - `yelp_business_id` string — Unique Yelp identifier of the business if available. Used as a hint when finding a matching business.
  - `options` object
    - `create_if_missing` boolean — Whether to create the business if no matching business is found. Defaults to true if not specified.
    - `use_matching_criteria_for_update` boolean — Whether to use the information in the matching criteria to also update the business. When true, the fields from the matching_criteria are merged into the update object. Any fields already present in the update object take precedence. Defaults to false if not specified.
  - `update` object — Provides rich content for the business. Please use the table below for reference to all 'update' attributes.
  - `partner_business_id` string — Optional unique partner identifier for the business. Must not contain leading or trailing spaces. When provided, partner identifiers cannot change and must remain unique. Maximum length is 100.

## Other responses

- `$ref`

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)