--- title: "Business Details" method: GET path: "/v3/businesses/{business_id_or_alias}" tags: ["Businesses"] --- # Business Details `GET /v3/businesses/{business_id_or_alias}` This endpoint returns detailed business content. Normally, you would get the Business ID from [/v3/businesses/search](https://docs.developer.yelp.com/reference/v3_business_search), [/v3/businesses/search/phone](https://docs.developer.yelp.com/reference/v3_business_phone_search), [/v3/transactions/{transaction_type}/search](https://docs.developer.yelp.com/reference/v3_transaction_search) or [/v3/autocomplete](https://docs.developer.yelp.com/reference/v3_autocomplete). To retrieve review excerpts for a business, please refer to our Reviews endpoint ([/v3/businesses/{id}/reviews](https://docs.developer.yelp.com/reference/v3_business_reviews)) **Note:** at this time, the API does not return businesses without any reviews. ## Path parameters - `business_id_or_alias` string, required ## Parameters - `#/paths/~1v3~1businesses~1search/get/parameters/6` — unresolved $ref - `#/paths/~1v3~1businesses~1search/get/parameters/12` — unresolved $ref ## Response `200` A Business with the requested Id was returned. - object — A Business Yelp finds based on the search criteria. - `id` BusinessId, required — unresolved $ref - `alias` string, required — Unique Yelp alias of this business. Can contain unicode characters. Example: 'yelp-san-francisco'. Also see What's the difference between the Yelp business ID and business alias? - `name` string, required — Name of this business. - `image_url` string — URL of photo for this business - `is_closed` boolean — Whether business has been (permanently) closed - `url` string — URL for business page on Yelp. - `review_count` integer — Number of reviews for this business. - `categories` array[] — List of category title and alias pairs associated with this business. - object[] — A list of Yelp Categories. - `alias` string, required — Alias of a category, when searching for business in certain categories, use alias rather than the title. - `title` string, required — Title of a category for display purpose. - `rating` unknown - `coordinates` object, required — Coordinates of this business. - `latitude` unknown, required - `longitude` unknown, required - `transactions` string[] — List of Yelp transactions that the business is registered for. Current supported values are **pickup**, **delivery** and **restaurant_reservation**. - `price` string — Price level of the business. Uses the currency symbol of the provided locale. Value for en_US is one of *$*, *$$*, *$$$* or *$$$$*. - `location` object, required — Location of this business, including address, city, state, zip code and country. - `address1` string — Street address of this business. - `address2` string — Street address of this business, continued. - `address3` string — Street address of this business, continued. - `city` string — City of this business. - `zip_code` string — [Zip code](https://en.wikipedia.org/wiki/Postal_code) of this business. - `country` string — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of this business. - `state` string — [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) (with a few [exceptions](https://docs.developer.yelp.com/docs/resources-state-codes)) state code of this business. - `display_address` string[], required — Array of strings that if organized vertically give an address that is in the standard address format for the business's country. - `cross_streets` string, nullable — Cross streets of this address - `phone` string, required — Phone number of the business. - `display_phone` string, required — Phone number of the business formatted nicely to be displayed to users. The format is the standard phone number format for the business's country. - `distance` unknown - `attributes` object — Various features or facilities provided by the business. **Yelp Places Premium tier** attributes, please apply [here](https://business.yelp.com/data/products/fusion/): * *liked_by_vegetarians* - is the business liked by vegetarians * *liked_by_vegans* - is the business liked by vegans * *hot_and_new* - has the business recently joined Yelp - `is_claimed` boolean, required — Whether business has been claimed by a business owner - `date_opened` string — Business opening date - `date_closed` string — Business closing date - `photos` string[], required — URLs of up to three photos of the business.

URLs of up to twelve photos of the business are available for **[Yelp Places Premium tier](https://business.yelp.com/data/products/fusion/)** users

- `special_hours` object[] — Out of the ordinary hours for the business that apply on certain dates. Whenever these are set, they will override the regular business hours found in the 'hours' field. - `date` string, date, required — An [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) date string representing the date for which these special hours apply. - `start` string — Start of the opening hours in a day, in [24-hour clock](https://en.wikipedia.org/wiki/24-hour_clock) notation, like 1000 means 10 AM. - `end` string — End of the opening hours in a day, in [24-hour clock](https://en.wikipedia.org/wiki/24-hour_clock) notation, like 2130 means 9:30 PM. - `is_overnight` boolean — Whether the special hours time range spans across midnight or not. When this is true, the end time will be lower than the start time. - `is_closed` boolean — Whether this particular special hour represents a date where the business is closed. - `messaging` object — Information and action links for messaging with this business via Yelp, including requesting quotes. - `url` string, required — Visit this action link URL to go directly into the business messaging flow for this business. - `use_case_text` string, required — Indicates what kind of messaging can be done with the business. e.g., "Request a Quote" for a home services business, or "Request a Consultation" for a legal services business. This text will be localized (see Localization). - `response_rate` unknown - `response_time` integer — Estimated response time in seconds.

Yelp Places Premium tier, please apply [here](https://business.yelp.com/data/products/fusion/)

- `is_enabled` boolean — Whether messaging is currently enabled. Access is disabled by default. See [Yelp Partner APIs](https://docs.developer.yelp.com/docs/yelp-partner-apis) on how to get access. - `photo_count` integer — Total number of photos

Yelp Places Premium tier, please apply [here](https://business.yelp.com/data/products/fusion/)

- `photo_details` object[] — List of photo details

Yelp Places Premium tier, please apply [here](https://business.yelp.com/data/products/fusion/)

- `photo_id` string — Unique identifier for a photo - `url` string — Photo URL - `caption` string — Photo caption - `width` integer — Photo width - `height` integer — Photo height - `is_user_submitted` boolean — Photo submitted by user - `user_id` string — Unique identifier for a user - `label` string — Photo label - `yelp_menu_url` string — Business menu URL

Yelp Places Premium tier, please apply [here](https://business.yelp.com/data/products/fusion/)

- `cbsa` string — Core based statistical area.

Yelp Insights Premium attribute, please apply [here](https://business.yelp.com/data/products/fusion-insights/)

- `popularity_score` object — Indicates popularity of a business with respect to other businesses belonging to the same primary category.

Yelp Insights Premium attributes, please apply [here](https://business.yelp.com/data/products/fusion-insights/)

- `primary_category` string — Business primary category - `score` unknown - `rapc` object — Information about Request a Phone Call for this business. Access is disabled by default. See [Yelp Partner APIs](https://docs.developer.yelp.com/docs/yelp-partner-apis) on how to get access. - `is_enabled` boolean — Whether Request a Phone Call is currently enabled. Request a Phone Call can be toggled via the [Enable/Disable Request a Phone Call endpoint](https://docs.developer.yelp.com/reference/v3_business_rapc_enabledness). - `is_eligible` boolean — Whether the given business is eligible for Request a Phone Call. The [Enable/Disable Request a Phone Call endpoint](https://docs.developer.yelp.com/reference/v3_business_rapc_enabledness) can only be used if the business is eligible. - `raq` object — Information about Request a Quote for this business. Access is disabled by default. See [Yelp Partner APIs](https://docs.developer.yelp.com/docs/yelp-partner-apis) on how to get access. - `is_enabled` boolean — Whether Request a Quote is currently enabled. - `licenses` object[] — List of verified licenses for the business. Access is disabled by default. To have access, please [contact us](https://business.yelp.com/data/products/places-api/#form). - `license_type` string — The type or category of the license. - `verification_date` string — The date the license was verified by Yelp (YYYY-MM-DD). - `expiration_date` string — The license expiration date (YYYY-MM-DD). - `issuing_authority` string — The authority or agency that issued the license. - `license_number` string — The license identification number. - `hours` object[], required — Regular business hours. - `hour_type` string, required — Type of business hours - `open` object[], required — List of open hours - `day` integer, required — Day of the week. - `start` string, required — Start of the opening hours in a day, in [24-hour clock](https://en.wikipedia.org/wiki/24-hour_clock) notation, like 1000 means 10 AM. - `end` string, required — End of the opening hours in a day, in [24-hour clock](https://en.wikipedia.org/wiki/24-hour_clock) notation, like 2130 means 9:30 PM. - `is_overnight` boolean, required — Whether the special hours time range spans across midnight or not. When this is true, the end time will be lower than the start time. - `is_open_now` boolean, required — Whether the business is open now - `online_reservation` object — Present when the business supports online reservations through Yelp. - `url` string — Link to the reservation page for this business, where users can select a date, time, and party size to book a table. ## Other responses - `400` — unresolved $ref - `401` — unresolved $ref - `403` — unresolved $ref - `404` — unresolved $ref - `413` — unresolved $ref - `429` — unresolved $ref - `500` — unresolved $ref - `503` — unresolved $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)