Claim Business operations documented in the Yelp developer reference: Claim Business; Claim Status.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/yelp:yelp-claim-business-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Claim Business API
version: '1.0'
servers:
- url: https://partner-api.yelp.com/
security:
- basic: []
tags:
- name: Claim Business
paths:
/v1/ingest/create:
post:
summary: Claim Business
tags:
- Claim Business
description: SMB Claiming API provides a means to submit a business claim and to revoke a business claim on Yelp.
operationId: claim_business_v1
requestBody:
description: Request body
required: true
content:
application/json:
schema:
type: object
properties:
matching_criteria:
$ref: '#/components/schemas/MatchingCriteria'
options:
type: object
properties:
create_if_missing:
type: boolean
description: Whether to create the business if no matching business is found. Defaults to true if not specified.
use_matching_criteria_for_update:
type: boolean
description: 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:
type: object
description: Provides rich content for the business. Please use the table below for reference to all 'update' attributes.
partner_business_id:
type: string
description: 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.
required:
- matching_criteria
responses:
$ref: '#/components/schemas/JobCreatedResponses'
/v2/partner_biz_claim/request/status:
get:
summary: Claim Status
tags:
- Claim Business
description: Obtain the claim status. You must first the Job Status Endpoint to see if the initial claim request succeeded.
operationId: get_partner_biz_claim_status_v1
parameters:
- in: query
name: job_id
required: true
schema:
type: string
description: Identifier of the job as returned from the Ingestion `POST`
- in: query
name: yelp_business_id
required: true
schema:
type: string
description: Yelp Business ID
responses:
$ref: '#/components/schemas/JobStatusResponses'
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.
'
address2:
type: string
description: 'The second line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.'': are allowed.
'
address3:
type: string
description: 'The third line of the business’s address. Maximum length is 64; only digits, letters, spaces, and _-’/#&,.'': are allowed.
'
city:
type: string
description: 'The city of the business. Maximum length is 64; only digits, letters, spaces, and _-’.() are allowed.
'
country:
type: string
description: 'The ISO 3166-1 alpha-2 country code of the business. Maximum length is 2.
'
latitude:
type: number
description: 'The WGS84 latitude of the business in decimal degrees. Must be between -90 and 90.
'
longitude:
type: number
description: 'The WGS84 longitude of the business in decimal degrees. Must be between -180 and 180.
'
name:
type: string
description: 'The name of the business. Maximum length is 64; only digits, letters, spaces, and _!#$%&+,-.’/:?@'' are allowed.
'
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.
'
postal_code:
type: string
description: 'The postal code of the business. Maximum length is 12.
'
state:
type: string
description: 'The ISO 3166-2 code for the region/province of the business. Maximum length is 3.
'
yelp_business_id:
type: string
description: 'Unique Yelp identifier of the business if available. Used as a hint when finding a matching business.
'
required:
- city
- country
- name
- postal_code
- state
JobStatus200Response:
description: '200'
content:
application/json:
schema:
type: object
properties:
partner_biz_claim_results:
type: array
items:
type: object
properties:
owner_claim_request:
type: object
properties:
request_status:
type: string
biz_user_email:
type: string
time_created:
type: string
signup_url:
type: url
yelp_business_id:
type: string
job_id:
type: string
errors:
type: string
examples:
Result:
value:
partner_biz_claim_results:
- owner_claim_request:
request_status: PENDING
biz_user_email: john@johns-restaurant.com
time_created: '2017-12-12 13:55:25'
signup_url: https://biz.yelp.com/partner-claim/BC1F95408261871EAF8538CCE2B5CFED767D695147873F76/Cy5rCoobuUhJsH071zMMvg/landing?utm_campaign=claim_business&utm_content=biz_owner_approve&utm_medium=partner_link&utm_source=claim_partner_link
yelp_business_id: Ak9iH80pR01lOgQ0wNTyPA
job_id: 5nhctdbrhydWeimreZ4R-Q
errors: null
JobStatusResponses:
'200':
$ref: '#/components/schemas/JobStatus200Response'
'400':
$ref: '#/components/schemas/Empty400Response'
JobCreated200Response:
description: '200'
content:
application/json:
schema:
type: object
properties:
job_id:
type: string
required:
- job_id
examples:
Result:
value:
job_id: prvtN-nilb4mUynGGgKuBQ
Empty400Response:
description: '400'
content:
application/json:
schema:
type: object
examples:
Result:
value: {}
JobCreatedResponses:
'200':
$ref: '#/components/schemas/JobCreated200Response'
'400':
$ref: '#/components/schemas/Empty400Response'
securitySchemes:
basic:
type: http
scheme: basic
x-provenance:
method: searched
source: https://docs.developer.yelp.com/reference
harvested: '2026-11-05'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://docs.developer.yelp.com/reference/claim_business_v1.md
- https://docs.developer.yelp.com/reference/get_partner_biz_claim_status_v1.md
merge:
pages: 2
deduped: 2
conflicts_kept_first: 0