> ## Documentation Index
> Fetch the complete documentation index at: https://birdeye-0229a3ce-cgupta-healthcare.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Change Logs
* 09/07/2026 - Updated the healthcare section in Create, Update, and Get Listing APIs: removed `university`, `hospitalAffiliations`, and `insurancesAccepted` fields, and added `educationDetails`, `hospitalAffiliationsDetails`, `insuranceDetails`, `conditions`, and `procedures` fields with new validations (error codes 2827-2841).
* 08/21/2026 - Added support for social events under the Subscription Service for Published Post, Failed Post, Rejected Post, and Channel Disconnected.
* 08/12/2026 - Added Get Survey Usage by Location API (`POST /v1/survey/{surveyId}/usage/by-location`) to retrieve survey sent data and response rate per location, with pagination and sort order support.
* 08/12/2026 - Updated the List Responses for a Survey API (`POST /v1/survey/ext/list/responses/{survey_id}`) response to include a `source` field at the response level and a `questionId` field within `childAnswers` items.
* 08/05/2026 - Added Social Media Upload and Track Upload Status APIs under the Social group to support async two-step media ingestion: submit up to 50 image/video URLs and poll for per-item processing results (V2BIRD-16118).
* 08/04/2026 - Extended hotel attributes support in Create, Update, and Get Listing APIs and Get Hotel Attributes API: added Property category (builtYear, lastRenovatedYear, roomsCount, floorsCount); added `attributeValueType` field to Get Hotel Attributes response with enum values BOOLEAN, INTEGER, YEAR, TIME, SINGLE\_SELECT, MULTI\_SELECT; updated supported attribute categories list (BIRD-12343).
* 08/03/2026 - Added new Insight Experience Over Time API (`POST /v1/insight/experience/over-time`) to retrieve time-series insight scores with support for hierarchy-level filtering and grouping.
* 08/03/2026 - Updated the existing Get Insight Experience Location Info API to include the `userEmail` field in the request body.
* 08/03/2026 - Added `userRole` field to the Get User Details API (`GET /v1/user/details`) response to return the user's role on the account.
* 07/03/2026 - Updated `mainBusinessDescription` and microsite `internalListing.description` fields in Create, Update and Get Listing APIs to be optional instead of required, with support for clearing the existing value by sending an empty string (V2BIRD-1690).
* 06/10/2026 - Updated Get Contact API to support an optional `experienceScore` boolean field in the request body (default: false). When set to true, the response includes the customer's experience score and source.
* 05/25/2026 - Added Update Custom card (PUT) and Delete Custom card (DELETE) API documentation under the Business profile custom card section.
* 05/11/2026 - Added support for backdated survey responses in the POST Survey Response API. The `created` field (UTC Epoch milliseconds) is optional; if omitted, the server defaults to the current UTC timestamp.
* 04/22/2026 - Provide subLocality field support in Get, Create and Update Listings APIs for NZ Locations.
* 04/16/2026 - Added Archived Get Reviews API under Reviews group.
* 04/06/2026 - Updated Get Reviews API documentation to improve clarity on review statuses and how to retrieve all review types.
* 03/24/2026 - Added Social Open URL Performance Report API and Insight AI APIs to retrieve location-wise metrics and benchmark score.
* 03/18/2026 - Added Create Custom Card Time API under custom fields section.
* 03/03/2026 - Added Response Time (overtime & by-location) and Response Rate(overtime & by-location) APIs under reports section and created group for Competitor AI.
* 03/02/2026 - Added sendInvite (boolean, default - true) field in Create User Signup v2 API request body and attributes.
* 02/11/2026 - Updated the API key identifier for applicable APIs by moving it from a query parameter to the x-api-key request header.
* 02/03/2026 - Added the "Get All QnA" API under FAQ group to enable retrieval of QnA entries across business locations, with full request and response documentation
* 01/19/2026 - Added a note under the Authentication and Rate limiting section specifying that the x-api-key header is mandatory for all API requests targeting EU region business accounts.
* 01/13/2026 - Added Create User (Signup) API under User module to create and invite users for a business.
* 09/22/2025 - Added GMB Products APIs to onboard/connect Google Merchant accounts and manage product listing actions.
* 08/21/2025 - Added Single main business description Support.
* 08/19/2025 - Added competitor /raptor public APIs for reviews aggregates.
* 06/26/2025 - Added Contact V2 APIs with communication preference flag support.
* 12/13/2024 - Added inline reply support for GetReviews APIs.
* 09/27/2024 - Added update for Google Opening Soon (BIRD-56987)
* 06/25/2024 - Updated Listings Insights API (BIRDEYE-137367)
* 05/29/2024 - Added Google Q\&A Developers API Section
* 05/13/2024 - Added epoc date support for GetReviews APIs.
* 03/22/2024 - Add Update Hierarchy API (BIRD-32609)
* 03/19/2024 - Added Ticket APIs Create, Get, Update APIs under Ticket module
* 02/26/2024 - Updated logoUrl description in Get, Update APIs under Business module and Create, Get, Update APIs under Listing module (BIRD-29386)
* 12/21/2023 - Add listing phase 2 api changes (BIRD-16589)
* 11/08/2023 - Add survey changes (BIRD-11944) and listing changes (BIRD-14345)
* 11/08/2023 - Added CRUD APIs for Apple chat
* 10/15/2023 - Added CRUD APIs for Business Media.
* 10/11/2023 - Added new APIs under Listing module, Create, Update, Get, Deactive Listings
* 09/18/2023 - Added new API under Contact module i.e, Get opt-out contact data
* 08/25/2023 - Added new APIs under Business and Listing modules, Get Category List API, Get GMB Attributes API & Get Timezone List
* 07/21/2023 - Added new API under Business module i.e, Business Search API.
* 06/30/2023 - Added support for service area based information in Get Business API and Update Business API.
* 10/04/2024 - Added support to fetch ticketId associated with the survey responses in List Response API.