# anny: German Developers

## Developers

- [German / Developers / Admin API (348 pages)](https://docs.anny.co/_llms/de/developers/admin-api.md): Documentation for German / Developers / Admin API.

### Guides

- [Getting Started](https://docs.anny.co/developers/index.md)
- [JSON-API Conventions](https://docs.anny.co/developers/guides/json-api-conventions.md)
- [Authentication](https://docs.anny.co/developers/guides/authentication.md)
- [Availability & Booking Search](https://docs.anny.co/developers/guides/availability.md)
- [Rate Limiting](https://docs.anny.co/developers/guides/rate-limiting.md)
- [Rich Content Media](https://docs.anny.co/developers/guides/rich-content-media.md): How images and videos are embedded in TipTap HTML fields, and how native apps should render them.
- [Booking Bundle Groups](https://docs.anny.co/developers/guides/booking-bundle-groups.md): JSON:API contract for grouping booking bundles in admin and native apps. Mirror service groups and add-on groups.

#### Admin guides

- [Admin Booking Creation](https://docs.anny.co/developers/guides/admin/booking-creation.md)
- [Admin Booking Edit](https://docs.anny.co/developers/guides/admin/booking-edit.md)
- [Admin Booking Lifecycle](https://docs.anny.co/developers/guides/admin/booking-lifecycle.md)
- [Invoices](https://docs.anny.co/developers/guides/admin/invoices.md)
- [Admin Customer Management](https://docs.anny.co/developers/guides/admin/customer-management.md)
- [Booking Calendars](https://docs.anny.co/developers/guides/admin/calendar-events.md)
- [Broadcast Campaigns](https://docs.anny.co/developers/guides/admin/broadcasting.md)
- [Exports](https://docs.anny.co/developers/guides/admin/exports.md)
- [Webhooks & Events](https://docs.anny.co/developers/guides/admin/webhooks.md)
- [Businesses](https://docs.anny.co/developers/guides/admin/businesses.md)
- [Customer Balances](https://docs.anny.co/developers/guides/admin/customer-balances.md)
- [Admin Timeslot Management](https://docs.anny.co/developers/guides/admin/timeslot-management.md)
- [Admin Resources](https://docs.anny.co/developers/guides/admin/resources.md)

#### Customer guides

- [Customer Booking Lifecycle](https://docs.anny.co/developers/guides/customer/booking-lifecycle.md)
- [Order & Checkout Flow (Public)](https://docs.anny.co/developers/guides/customer/checkout.md)
- [Plans & Subscriptions](https://docs.anny.co/developers/guides/customer/plans-subscriptions.md)
- [Communities & Access Control](https://docs.anny.co/developers/guides/customer/communities.md)
- [Waitlist](https://docs.anny.co/developers/guides/customer/waitlist.md)

### Customer API

- [Customer API](https://docs.anny.co/developers/api-reference/customer.md)

#### Availability & Search

- [Check availability](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/check-availability.md): Check availability of a service and resource for a given period.
- [Get end times for start date times for a resource](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-end-times-for-start-date-times-for-a-resource.md): Get all interval end dates for a start datetime.
- [Get start times for a start date for a resource](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-start-times-for-a-start-date-for-a-resource.md): Get all interval start dates for a given date.
- [Check availability for a date range](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/check-availability-for-a-date-range.md): Returns whether a given period is available for a service/resource combination.
- [Get available start dates for a period](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-available-start-dates-for-a-period.md): Returns an array of dates that have available slots within the given range.
- [Get the next available start date](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-the-next-available-start-date.md)
- [Get available start times for a date](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-available-start-times-for-a-date.md): Returns available start time intervals for the given date and service/resource.
- [Get available end times for a start time](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-available-end-times-for-a-start-time.md): Given a start datetime, returns available end time intervals.
- [Get availability periods](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-availability-periods.md): Returns availability periods for the given service/resource, useful for calendar display.
- [Get upcoming available intervals](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-upcoming-available-intervals.md)
- [Get availability for recurring bookings](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-availability-for-recurring-bookings.md)
- [Get availability for a timeslot series](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-availability-for-a-timeslot-series.md)
- [Get intervals for a timeslot series](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-intervals-for-a-timeslot-series.md)
- [Get start intervals for waitlist entries](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-start-intervals-for-waitlist-entries.md): Returns waitlist-eligible start intervals for a service. Use this only after deciding the user should be offered waitlist for a booked out resource or period.
- [Get end intervals for waitlist entries](https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-end-intervals-for-waitlist-entries.md): Returns waitlist-eligible end intervals for a previously selected waitlist start datetime.

#### Booking Management

- [Get list of bookings](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/get-list-of-bookings.md): Auth: customer. Get a list of all bookings for the authenticated customer account which apply to the given filter.
- [Cancel a booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/cancel-a-booking.md): Auth: optional. This endpoint allows a customer to cancel a booking either anonymously via the access token or via customer login.
- [Create an instant booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/create-an-instant-booking.md): Auth: customer. Creates and completes a booking immediately without going through the cart flow. Used for authenticated customer and kiosk-like flows.
- [Find a booking by its number](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/find-a-booking-by-its-number.md): Auth: optional. Lookup is authenticated with the terminal hash rather than customer bearer auth.
- [Find a booking by a scan code](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/find-a-booking-by-a-scan-code.md): Auth: optional. Lookup is authenticated with the terminal hash rather than customer bearer auth.
- [Accept a booking invitation](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/accept-a-booking-invitation.md)
- [Reject a booking invitation](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/reject-a-booking-invitation.md)
- [Personalize a booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/personalize-a-booking.md): Submit personalization data (custom form fields) for a booking.
- [Preview cancellation terms for a booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/preview-cancellation-terms-for-a-booking.md): Returns potential refund amounts and cancellation policy terms based on current time.
- [Edit participants for a booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/edit-participants-for-a-booking.md)
- [Edit service options (add-ons) for a confirmed booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/edit-service-options-add-ons-for-a-confirmed-booking.md)
- [Edit base data of a completed booking](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/edit-base-data-of-a-completed-booking.md): Allows editing the date/time of a completed booking (subject to availability). This endpoint applies the change immediately — there is no separate confirm step. If the edit causes a price difference, a new invoice is generated.
- [Cancel an in-progress booking edit](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/cancel-an-in-progress-booking-edit.md)
- [Get the count of bookings for resources](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/get-the-count-of-bookings-for-resources.md)
- [Get unified calendar events for resources](https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/get-unified-calendar-events-for-resources.md): Aggregates availability, bookings, and blockers into unified calendar events for display. In an organization/admin context, timeslot and single-booking `display_lines` include the timeslot title when one is set. Each display line is `{ key, icon, label, image, object }`; `key` is one of `time`, `tim…

#### Orders & Checkout

- [Get or create an active order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-or-create-an-active-order.md): Auth: optional. This endpoint will return the currently active order (indentified by a cookie). Otherwise, the response would be empty.
- [Finish an order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/finish-an-order.md): This endpoint is necessary to complete an order. The response is an array of orders, one for each organization involved, since the booked resources may be offered by different organizations.
- [Add booking to order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/add-booking-to-order.md): This endpoint allows to add bookings to an order with status "draft". After the booking has changed the status, no more changes are possible from the customer side. There does not have to exist an order beforehand, because it is created as soon as the first booking is added.
- [Precalculate a possible booking](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/precalculate-a-possible-booking.md): This endpoint allows to precalculate a booking without creating it.
- [Delete a booking from an order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/delete-a-booking-from-an-order.md): This endpoint allows to delete the booking of an order that is still in status "draft". After the booking has changed the status, no more changes are possible from the customer side.  If there are no more bookings in the order, the entire order is deleted.
- [Apply voucher](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/apply-voucher.md): This endpoint allows to apply a voucher code to an order. The server side will validate this voucher and return error messages if needed.
- [Delete voucher](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/delete-voucher.md): This endpoint allows to delete a voucher code from an order.
- [Get an order after ordering](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-an-order-after-ordering.md): Auth: optional. This endpoint allows a customer to access an order via the **order number** after placing it. This can be authenticated either anonymously via the order `access_token` or via customer login.
- [Cancel an order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/cancel-an-order-get-orders-record-cancel.md): Auth: optional. This endpoint allows a customer to cancel an order via the **order number**. This can be done either anonymously via the access token or via the customer login. Canceling the order will also cancel all related bookings.
- [Cancel an order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/cancel-an-order-get-orders-record-resend-mail.md): Auth: optional. This endpoint allows a customer to resend the booking confirmation via the **order number**. This can be done either anonymously via the access token or via customer login. This only re-sends the confirmation email and does not modify the order.
- [Delete multiple bookings from the cart](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/delete-multiple-bookings-from-the-cart.md)
- [Edit add-ons for a booking in the cart](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/edit-add-ons-for-a-booking-in-the-cart.md)
- [Clear all bookings from the cart](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/clear-all-bookings-from-the-cart.md)
- [Get booking recommendations for the current order](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-booking-recommendations-for-the-current-order.md)
- [Get recently completed orders](https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-recently-completed-orders.md)

#### Account

- [Get all favorites](https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/get-all-favorites.md): Get all favorite models of the logged in customer account.
- [Add a favorite](https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/add-a-favorite.md): Create new favorite for model.
- [Delete a favorite](https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/delete-a-favorite.md): Remove a favorite.
- [Get customer account information](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-customer-account-information-list-customer-accounts.md): Fetch the logged in customer identified by Bearer Token.
- [Get customer account information](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-customer-account-information-get-customer-accounts-record.md)
- [Update customer account information](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/update-customer-account-information.md): Use this endpoint to update the addresses or the primary address of a customer account. All attributes are managed by the authentication system.
- [Get all addresses linked with a customer account](https://docs.anny.co/developers/api-reference/customer/endpoints/addresses/get-all-addresses-linked-with-a-customer-account.md)
- [Get all liked resources](https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/get-all-liked-resources.md): Get all liked resources for the logged in customer account.
- [Validate email/mobile uniqueness for a customer account](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/validate-email-mobile-uniqueness-for-a-customer-account.md)
- [Request account deletion](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/request-account-deletion.md)
- [Get booking previews for a customer account](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-booking-previews-for-a-customer-account.md)
- [Get a single booking preview](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-a-single-booking-preview.md)
- [Remove a recently visited entity from history](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/remove-a-recently-visited-entity-from-history.md)
- [Get connections with accessible scope](https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-connections-with-accessible-scope.md)
- [Revoke an account pass](https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/revoke-an-account-pass.md)
- [Update community-account](https://docs.anny.co/developers/api-reference/customer/endpoints/community-accounts/update-community-account.md)
- [Delete community-account](https://docs.anny.co/developers/api-reference/customer/endpoints/community-accounts/delete-community-account.md)
- [List account-passes](https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/list-account-passes.md)
- [Create account pass](https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/create-account-pass.md)
- [Get account pass](https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/get-account-pass.md)
- [Update account pass](https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/update-account-pass.md)
- [Delete account pass](https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/delete-account-pass.md)
- [Create account-skill](https://docs.anny.co/developers/api-reference/customer/endpoints/account-skills/create-account-skill.md)
- [Update account-skill](https://docs.anny.co/developers/api-reference/customer/endpoints/account-skills/update-account-skill.md)
- [Delete account-skill](https://docs.anny.co/developers/api-reference/customer/endpoints/account-skills/delete-account-skill.md)

#### Communities

- [List communities](https://docs.anny.co/developers/api-reference/customer/endpoints/communities/list-communities.md): Auth: customer. Lists communities visible to the authenticated customer account.
- [Get community](https://docs.anny.co/developers/api-reference/customer/endpoints/communities/get-community.md): Auth: customer. Returns a community the authenticated customer can access.
- [Get community invite](https://docs.anny.co/developers/api-reference/customer/endpoints/community-invites/get-community-invite.md): Auth: customer. Returns an invite for the authenticated customer account.
- [Accept community invite](https://docs.anny.co/developers/api-reference/customer/endpoints/community-invites/accept-community-invite.md): Auth: customer. Accepts a community invite for the authenticated customer account.
- [Leave a community](https://docs.anny.co/developers/api-reference/customer/endpoints/communities/leave-a-community.md): Auth: customer. Removes the authenticated customer from the community.

#### Passes, Plans & Queue

- [List waitlist-spots](https://docs.anny.co/developers/api-reference/customer/endpoints/waitlist/list-waitlist-spots.md): Returns active waitlist entries for the authenticated customer. Past entries and entries already converted to bookings are excluded.
- [Create waitlist-spot](https://docs.anny.co/developers/api-reference/customer/endpoints/waitlist/create-waitlist-spot.md): Creates a waitlist entry for the authenticated customer. `account_id`, `organization_id`, and `uuid` are filled by the backend.
- [Delete waitlist-spot](https://docs.anny.co/developers/api-reference/customer/endpoints/waitlist/delete-waitlist-spot.md)
- [List plan-subscriptions](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/list-plan-subscriptions.md)
- [Create plan-subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/create-plan-subscription.md)
- [Get plan-subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/get-plan-subscription.md)
- [Update plan-subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/update-plan-subscription.md)
- [Delete plan-subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/delete-plan-subscription.md)
- [Cancel subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/cancel-subscription.md)
- [List booking-passes](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/list-booking-passes.md)
- [Create booking pass](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/create-booking-pass.md)
- [Get booking pass](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/get-booking-pass.md)
- [Update booking pass](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/update-booking-pass.md)
- [Delete booking pass](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/delete-booking-pass.md)
- [Purchase a booking pass](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/purchase-a-booking-pass.md)
- [Get booking-bundle](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-bundles/get-booking-bundle.md)
- [Offered booking bundle groups](https://docs.anny.co/developers/api-reference/customer/offered-booking-bundle-groups.md): Public catalog of booking bundle groups that have at least one live bundle.
- [Get booking-quota-grant](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-quota-grants/get-booking-quota-grant.md)
- [Get all quota grants](https://docs.anny.co/developers/api-reference/customer/endpoints/booking-quota-grants/get-all-quota-grants.md)
- [Get queue-ticket](https://docs.anny.co/developers/api-reference/customer/endpoints/queues/get-queue-ticket.md)
- [Update queue-ticket](https://docs.anny.co/developers/api-reference/customer/endpoints/queues/update-queue-ticket.md)
- [Cancel queue ticket](https://docs.anny.co/developers/api-reference/customer/endpoints/queues/cancel-queue-ticket.md)
- [Claim a plan subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/claim-a-plan-subscription.md)
- [Revoke a plan subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/revoke-a-plan-subscription.md)
- [Suspend a plan subscription](https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/suspend-a-plan-subscription.md)
- [Create a queue ticket from a booking](https://docs.anny.co/developers/api-reference/customer/endpoints/queue-tickets/create-a-queue-ticket-from-a-booking.md)

#### Resources & Services

- [Get booking panel configuration for a service](https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-booking-panel-configuration-for-a-service.md): Returns structured configuration including available options, next available date, and booking constraints for the service.
- [Get a property](https://docs.anny.co/developers/api-reference/customer/endpoints/properties/get-a-property.md)
- [Get unique select options for property filter](https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-unique-select-options-for-property-filter.md): When filtering properties of a resource, properties with value type string need to be filtered with one or more of these distsict options.
- [Get available properties](https://docs.anny.co/developers/api-reference/customer/endpoints/properties/get-available-properties.md): This endpoint allows listing all available properties (for a given resource category). Properties can be used to filter resources by adding the following query params to any /resources endpoint:
- [Get resources of an organization](https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-resources-of-an-organization.md)
- [Get services of an organization](https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-services-of-an-organization.md)
- [Get gallery images for a given resource](https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-gallery-images-for-a-given-resource.md)
- [Get a resource](https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-a-resource.md)
- [Get resource childrens for a given resource](https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-resource-childrens-for-a-given-resource.md): For a full list of query params, please see /organizations/{organization_slug}/resources.
- [Get services of a resource](https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-services-of-a-resource.md): Request a list of services for a resource. Optionally include related `add_ons` and `sub_resources`.
- [Get community access restrictions for a resource](https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-community-access-restrictions-for-a-resource.md)
- [Get resource locations for map display](https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-resource-locations-for-map-display.md)
- [Get a list of services](https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-a-list-of-services.md): Only for sub-platforms.
- [Get a service](https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-a-service.md): Get a service by slug.
- [Get available add-ons for a given service](https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-available-add-ons-for-a-given-service.md)
- [Get available resources for a given service](https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-available-resources-for-a-given-service.md)
- [Get sub resources for a given services](https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-sub-resources-for-a-given-services.md)

#### Organization Discovery

- [Get an organization](https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-an-organization.md)
- [Get the privacy policy for an organization](https://docs.anny.co/developers/api-reference/customer/endpoints/legal-documents/get-the-privacy-policy-for-an-organization.md)
- [Get terms and conditions for an organization](https://docs.anny.co/developers/api-reference/customer/endpoints/legal-documents/get-terms-and-conditions-for-an-organization.md)

### Data models

#### Scalar reference catalog

- [AccessControlGrant](https://docs.anny.co/developers/models/access-control-grants.md)
- [AccountPass](https://docs.anny.co/developers/models/account-passes.md)
- [AccountSkill](https://docs.anny.co/developers/models/account-skills.md)
- [Add-On](https://docs.anny.co/developers/models/add-ons.md)
- [AddOnGroup](https://docs.anny.co/developers/models/add-on-groups.md)
- [Address](https://docs.anny.co/developers/models/addresses.md)
- [Booking](https://docs.anny.co/developers/models/bookings.md)
- [BookingAddOn](https://docs.anny.co/developers/models/booking-add-ons.md)
- [BookingBundle](https://docs.anny.co/developers/models/booking-bundles.md)
- [BookingBundleGroup](https://docs.anny.co/developers/models/booking-bundle-groups.md): Logical grouping of booking bundles, analogous to service groups and add-on groups.
- [BookingParticipant](https://docs.anny.co/developers/models/booking-participants.md)
- [BookingPass](https://docs.anny.co/developers/models/booking-passes.md)
- [BookingQuota](https://docs.anny.co/developers/models/booking-quotas.md)
- [BookingQuotaGrant](https://docs.anny.co/developers/models/booking-quota-grants.md)
- [BookingRule](https://docs.anny.co/developers/models/booking-rules.md)
- [BookingSeries](https://docs.anny.co/developers/models/booking-series.md)
- [BroadcastAudience](https://docs.anny.co/developers/models/broadcast-audiences.md)
- [BroadcastCampaign](https://docs.anny.co/developers/models/broadcast-campaigns.md)
- [BroadcastMessage](https://docs.anny.co/developers/models/broadcast-messages.md)
- [BroadcastTemplate](https://docs.anny.co/developers/models/broadcast-templates.md)
- [Calendar](https://docs.anny.co/developers/models/calendars.md)
- [Calendar Resource](https://docs.anny.co/developers/models/calendar-resources.md)
- [CancellationPolicy](https://docs.anny.co/developers/models/cancellation-policies.md)
- [Checkout Field](https://docs.anny.co/developers/models/checkout-fields.md)
- [Community](https://docs.anny.co/developers/models/communities.md)
- [CommunityAccount](https://docs.anny.co/developers/models/community-accounts.md)
- [CommunityInvite](https://docs.anny.co/developers/models/community-invites.md)
- [ContextRestriction](https://docs.anny.co/developers/models/context-restrictions.md)
- [CustomField](https://docs.anny.co/developers/models/custom-fields.md)
- [CustomForm](https://docs.anny.co/developers/models/custom-forms.md)
- [Customer](https://docs.anny.co/developers/models/customers.md)
- [CustomerAccount](https://docs.anny.co/developers/models/customer-accounts.md)
- [Customer Balance](https://docs.anny.co/developers/models/customer-balances.md)
- [Display](https://docs.anny.co/developers/models/displays.md)
- [DisplayPanel](https://docs.anny.co/developers/models/display-panels.md)
- [DisplayType](https://docs.anny.co/developers/models/display-types.md)
- [DocumentAcceptance](https://docs.anny.co/developers/models/document-acceptances.md)
- [DocumentTemplate](https://docs.anny.co/developers/models/document-templates.md)
- [Export](https://docs.anny.co/developers/models/exports.md)
- [ExportDestination](https://docs.anny.co/developers/models/export-destinations.md)
- [ExportSchedule](https://docs.anny.co/developers/models/export-schedules.md)
- [ExternalCalendar](https://docs.anny.co/developers/models/external-calendars.md)
- [Favorite](https://docs.anny.co/developers/models/favorites.md)
- [File](https://docs.anny.co/developers/models/files.md)
- [Image](https://docs.anny.co/developers/models/images.md)
- [Industry](https://docs.anny.co/developers/models/industries.md)
- [Interval Availability](https://docs.anny.co/developers/models/interval-availability.md)
- [Invoice](https://docs.anny.co/developers/models/invoices.md)
- [Item](https://docs.anny.co/developers/models/items.md)
- [LegalDocument](https://docs.anny.co/developers/models/legal-documents.md)
- [LegalDocumentLink](https://docs.anny.co/developers/models/legal-document-links.md)
- [ModelIdentifier](https://docs.anny.co/developers/models/model-identifiers.md)
- [Order](https://docs.anny.co/developers/models/orders.md)
- [Organization](https://docs.anny.co/developers/models/organizations.md)
- [OrganizationUser](https://docs.anny.co/developers/models/organization-users.md)
- [Payment](https://docs.anny.co/developers/models/payments.md)
- [PaymentAccount](https://docs.anny.co/developers/models/payment-accounts.md)
- [PaymentRefund](https://docs.anny.co/developers/models/payment-refunds.md)
- [PaymentSetup](https://docs.anny.co/developers/models/payment-setups.md)
- [Plan](https://docs.anny.co/developers/models/plans.md)
- [PlanSubscription](https://docs.anny.co/developers/models/plan-subscriptions.md)
- [PriceModifier](https://docs.anny.co/developers/models/price-modifiers.md)
- [Property](https://docs.anny.co/developers/models/properties.md)
- [QueueTicket](https://docs.anny.co/developers/models/queue-tickets.md)
- [Resource](https://docs.anny.co/developers/models/resources.md)
- [ResourceCategory](https://docs.anny.co/developers/models/resource-categories.md)
- [ResourceGroup](https://docs.anny.co/developers/models/resource-groups.md)
- [ResourceProperty](https://docs.anny.co/developers/models/resource-properties.md)
- [ResourceScheduleGroup](https://docs.anny.co/developers/models/resource-schedule-groups.md)
- [Scan](https://docs.anny.co/developers/models/scans.md)
- [Schedule](https://docs.anny.co/developers/models/schedules.md)
- [ScheduleGroup](https://docs.anny.co/developers/models/schedule-groups.md)
- [Service](https://docs.anny.co/developers/models/services.md)
- [ServiceAddOn](https://docs.anny.co/developers/models/service-add-ons.md)
- [ServiceConfiguration](https://docs.anny.co/developers/models/service-configurations.md)
- [ServiceGroup](https://docs.anny.co/developers/models/service-groups.md)
- [ServiceSubResource](https://docs.anny.co/developers/models/service-sub-resources.md)
- [Setting](https://docs.anny.co/developers/models/settings.md)
- [Subscription](https://docs.anny.co/developers/models/subscriptions.md)
- [Subscription Invoice](https://docs.anny.co/developers/models/subscription-invoices.md)
- [SyncSource](https://docs.anny.co/developers/models/sync-sources.md)
- [Tag](https://docs.anny.co/developers/models/tags.md)
- [Test](https://docs.anny.co/developers/models/tests.md)
- [Test Result](https://docs.anny.co/developers/models/test-results.md)
- [Timeslot](https://docs.anny.co/developers/models/timeslots.md)
- [TimeslotResourceAllocation](https://docs.anny.co/developers/models/timeslot-resource-allocations.md)
- [TimeslotSeries](https://docs.anny.co/developers/models/timeslot-series.md)
- [User](https://docs.anny.co/developers/models/users.md)
- [UserInvite](https://docs.anny.co/developers/models/user-invites.md)
- [View](https://docs.anny.co/developers/models/views.md)
- [Validated Interval](https://docs.anny.co/developers/models/validated-interval.md)
- [Voucher](https://docs.anny.co/developers/models/vouchers.md)
- [WaitlistSpot](https://docs.anny.co/developers/models/waitlist-spots.md)
- [WebhookSubscription](https://docs.anny.co/developers/models/webhook-subscriptions.md)
- [has-many-relationship](https://docs.anny.co/developers/models/json-api-has-many-relationship.md)
- [has-one-relationship](https://docs.anny.co/developers/models/json-api-has-one-relationship.md)
- [identifier](https://docs.anny.co/developers/models/json-api-identifier.md)
- [ResourceLinks](https://docs.anny.co/developers/models/json-api-links.md)
- [relationship](https://docs.anny.co/developers/models/json-api-relationship.md)

#### Additional schemas

- [Ability](https://docs.anny.co/developers/models/abilities.md)
- [AccountConnection](https://docs.anny.co/developers/models/account-connections.md)
- [Activity](https://docs.anny.co/developers/models/activities.md)
- [AuthUser](https://docs.anny.co/developers/models/auth-user.md)
- [BankAccount](https://docs.anny.co/developers/models/bank-accounts.md)
- [BusinessAccountMember](https://docs.anny.co/developers/models/business-account-members.md)
- [BusinessAccount](https://docs.anny.co/developers/models/business-accounts.md)
- [Business](https://docs.anny.co/developers/models/businesses.md)
- [ExternalLink](https://docs.anny.co/developers/models/external-links.md)
- [FcmToken](https://docs.anny.co/developers/models/fcm-tokens.md)
- [Integration](https://docs.anny.co/developers/models/integrations.md)
- [Notification](https://docs.anny.co/developers/models/notifications.md)
- [Organization-User Settings](https://docs.anny.co/developers/models/organization-user-settings.md)
- [Pairing Code](https://docs.anny.co/developers/models/pairing-codes.md)
- [PaymentMethod](https://docs.anny.co/developers/models/payment-methods.md)
- [ResourceMap](https://docs.anny.co/developers/models/resource-maps.md)
- [Role](https://docs.anny.co/developers/models/roles.md)
- [Table Column](https://docs.anny.co/developers/models/table-column.md)
- [Tally Counter Record](https://docs.anny.co/developers/models/tally-counter-records.md)
- [Tally Counter](https://docs.anny.co/developers/models/tally-counters.md)
- [TerminalLocation](https://docs.anny.co/developers/models/terminal-locations.md)
- [TerminalReader](https://docs.anny.co/developers/models/terminal-readers.md)

### Customer internal API

#### Account

- [Create an address](https://docs.anny.co/developers/api-reference/internal/customer/addresses/create-an-address.md): Create a standalone address resource. The business-account settings flow uses this to create a new primary address before linking it to the business account.
- [Update an address](https://docs.anny.co/developers/api-reference/internal/customer/addresses/update-an-address.md): Update an existing address resource. Used when editing an already-linked business-account primary address.
- [Delete an address](https://docs.anny.co/developers/api-reference/internal/customer/addresses/delete-an-address.md)
- [Get a business account](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/get-a-business-account.md): Returns the membership-aware business-account payload for the active customer.
- [Update a business account](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/update-a-business-account.md): Update editable business-account attributes and relationships such as `primary_address` or `logo_image`. Only active owners/admins may update.
- [Create or join a business account](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/create-or-join-a-business-account.md): Create a new business account or join an existing one matched by slug and domain.
- [Invite a member to a business account](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/invite-a-member-to-a-business-account.md): Invite an existing or future customer account by email. Backend support exists even though the current shop UI hides this action.
- [Request to join a linked business account](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/request-to-join-a-linked-business-account.md): Transition a linked membership to pending so an owner or admin can approve it.
- [Accept a business account invite](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/accept-a-business-account-invite.md)
- [Reject a business account invite](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/reject-a-business-account-invite.md)
- [Get a business account member](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/get-a-business-account-member.md): Returns a single membership resource. Owners/admins may read memberships in their business account. Use `include=business_account,customer_account` for related resources.
- [Update a business account member](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/update-a-business-account-member.md): Generic JSON:API update for membership attributes. The dedicated approve, promote, and demote actions are the intended workflow-specific endpoints.
- [Leave or remove a business account membership](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/leave-or-remove-a-business-account-membership.md): Delete your own membership to leave/cancel, or remove another member if the caller has sufficient permissions.
- [Approve a pending business account member](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/approve-a-pending-business-account-member.md): Approve a pending membership and transition it to active.
- [Promote a business account member](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/promote-a-business-account-member.md): Promote an active member to `admin` or `owner`.
- [Demote a business account member](https://docs.anny.co/developers/api-reference/internal/customer/business-accounts/demote-a-business-account-member.md): Demote an owner/admin back to `member`. Demoting the sole owner fails.

#### Access Control

- [List access-control grants for a customer](https://docs.anny.co/developers/api-reference/internal/customer/access-control/list-access-control-grants-for-a-customer.md): Retrieve all access-control grants for a specific customer account. Use the `filter[valid_today]` parameter to return only grants that are active or overlapping today.
- [Remote-open a lock](https://docs.anny.co/developers/api-reference/internal/customer/access-control/remote-open-a-lock.md): Triggers a remote unlock for the physical lock associated with this access-control grant.

#### Notifications

- [Store FCM token](https://docs.anny.co/developers/api-reference/internal/customer/notifications/store-fcm-token.md): Register a Firebase Cloud Messaging (FCM) device token for the authenticated user. Used to enable push notifications to a specific device. Call this on app startup and whenever the FCM token is refreshed.
- [Remove FCM token](https://docs.anny.co/developers/api-reference/internal/customer/notifications/remove-fcm-token.md): Unregister an FCM device token. Call this on logout or when the user disables push notifications on a device to stop delivering push notifications to it.
- [List notifications](https://docs.anny.co/developers/api-reference/internal/customer/notifications/list-notifications.md): Retrieve the in-app notification feed for the authenticated customer account.
- [Count unseen notifications](https://docs.anny.co/developers/api-reference/internal/customer/notifications/count-unseen-notifications.md): Returns the number of notifications that have not yet been seen (i.e. badge count).
- [Mark all notifications as read](https://docs.anny.co/developers/api-reference/internal/customer/notifications/mark-all-notifications-as-read.md): Marks all unread notifications for the authenticated user as read.
- [Update notification read/seen status](https://docs.anny.co/developers/api-reference/internal/customer/notifications/update-notification-read-seen-status.md): Update `read_at` or `seen_at` timestamps on a notification to mark it as read or seen.

#### Payments

- [List payment setups](https://docs.anny.co/developers/api-reference/internal/customer/payment-setups/list-payment-setups.md): Retrieve all payment setups configured for the organization.
- [Create payment setup](https://docs.anny.co/developers/api-reference/internal/customer/payment-setups/create-payment-setup.md): Create a new payment setup for the organization.
- [Get payment setup](https://docs.anny.co/developers/api-reference/internal/customer/payment-setups/get-payment-setup.md): Retrieve a specific payment setup.
- [Update payment setup](https://docs.anny.co/developers/api-reference/internal/customer/payment-setups/update-payment-setup.md): Update attributes of an existing payment setup.
- [Delete payment setup](https://docs.anny.co/developers/api-reference/internal/customer/payment-setups/delete-payment-setup.md): Remove a payment setup from the organization.

#### Connected Persons

- [Create or update a connection](https://docs.anny.co/developers/api-reference/internal/customer/connections/create-or-update-a-connection.md): Create a new connection or update an existing one between the authenticated customer and another person. The backend determines whether this is a new connection or an update based on the `connectedPerson` identity.
- [List all connections](https://docs.anny.co/developers/api-reference/internal/customer/connections/list-all-connections.md): Retrieve all connections for the authenticated customer account. Returns connected persons along with their granted and accessible scopes.
- [Remove a connection](https://docs.anny.co/developers/api-reference/internal/customer/connections/remove-a-connection.md): Remove a connection or revoke a pending outgoing connection request.
- [List accounts with a specific accessible scope](https://docs.anny.co/developers/api-reference/internal/customer/connections/list-accounts-with-a-specific-accessible-scope.md): Returns all customer accounts that the authenticated user has an accessible scope grant for. Used to determine who can be booked on behalf of, for example.
- [Accept a connection request](https://docs.anny.co/developers/api-reference/internal/customer/connections/accept-a-connection-request.md): Accept an incoming connection request from another customer account.
- [Decline a connection request](https://docs.anny.co/developers/api-reference/internal/customer/connections/decline-a-connection-request.md): Decline an incoming connection request from another customer account.

#### Internal UI

- [Get dynamic checkout form for order checkout](https://docs.anny.co/developers/api-reference/internal/customer/internal-ui/get-dynamic-checkout-form-for-order-checkout.md): Returns dynamic checkout field definitions and validation metadata. Supports prefill via remember customer token (`rct`).

### Admin internal API

#### Service Configuration

- [Create a new test result](https://docs.anny.co/developers/api-reference/internal/admin/test-results/create-a-new-test-result.md)

#### Plans & Passes

- [Resolve booking quota grants for from-config cart bookings](https://docs.anny.co/developers/api-reference/internal/admin/booking-quotas/resolve-booking-quota-grants-for-from-config-cart-bookings.md): Resolves eligible booking quota grants for each booking in an admin from-config payload.

#### Orders & Billing

- [Build admin checkout form from booking configuration](https://docs.anny.co/developers/api-reference/internal/admin/orders/build-admin-checkout-form-from-booking-configuration.md): Builds a dynamic admin form for order completion based on booking input (service, resource, time). This response can be rendered directly by the Admin UI form renderer. Supports mixed product orders — the config may contain bookings, standalone add-ons (`add_ons`) and booking passes purchased from b…
- [Apply admin checkout form data to booking configuration](https://docs.anny.co/developers/api-reference/internal/admin/orders/apply-admin-checkout-form-data-to-booking-configuration.md): Resolves or creates customers and maps submitted form values into a config payload that can be sent to POST /api/v1/orders/from-config. Additional config keys such as `add_ons` and `booking_passes` are passed through unchanged; `bookings` may be omitted for bundle/add-on-only orders.
- [Get standalone admin customer form](https://docs.anny.co/developers/api-reference/internal/admin/orders/get-standalone-admin-customer-form.md): Returns standalone customer and address form sections for admin workflows. If customer_id is provided, the form is prefilled with existing customer data. Customer fields are keyed under customer.* and address fields are keyed under address.* in sync with the customer and address API resource attribu…
- [Get standalone admin address form](https://docs.anny.co/developers/api-reference/internal/admin/orders/get-standalone-admin-address-form.md): Returns standalone address form fields for admin workflows. If customer_id is provided, the form is prefilled with the customer's latest address. Address fields are keyed under address.*.
- [Get standalone admin order custom fields form](https://docs.anny.co/developers/api-reference/internal/admin/orders/get-standalone-admin-order-custom-fields-form.md): Returns order-level custom fields prefilled from an existing order.
- [Get standalone admin booking custom fields form](https://docs.anny.co/developers/api-reference/internal/admin/orders/get-standalone-admin-booking-custom-fields-form.md): Returns booking-level custom fields prefilled from an existing booking.
- [Apply admin booking custom fields form](https://docs.anny.co/developers/api-reference/internal/admin/orders/apply-admin-booking-custom-fields-form.md): Persists submitted booking custom-field values for an existing booking. Filled `custom_entry_map.{uuid}.value` entries are written; values cleared to empty string or null are deleted. Fields outside this form are left untouched.

#### Terminal Payments

- [List terminal locations](https://docs.anny.co/developers/api-reference/internal/admin/terminal-locations/list-terminal-locations.md): Returns all terminal locations registered for the organization.
- [Create terminal location](https://docs.anny.co/developers/api-reference/internal/admin/terminal-locations/create-terminal-location.md): Creates a new terminal location and syncs it to Stripe.
- [Get terminal location](https://docs.anny.co/developers/api-reference/internal/admin/terminal-locations/get-terminal-location.md): Returns a single terminal location by UUID.
- [Update terminal location](https://docs.anny.co/developers/api-reference/internal/admin/terminal-locations/update-terminal-location.md): Updates a terminal location. Changes (including address) are automatically synced to Stripe.
- [Delete terminal location](https://docs.anny.co/developers/api-reference/internal/admin/terminal-locations/delete-terminal-location.md): Deletes the terminal location from Stripe and the local database.
- [List terminal readers](https://docs.anny.co/developers/api-reference/internal/admin/terminal-readers/list-terminal-readers.md): Returns all Stripe Terminal readers registered for the organization.
- [Register terminal reader](https://docs.anny.co/developers/api-reference/internal/admin/terminal-readers/register-terminal-reader.md): Registers a new Stripe Terminal reader using the pairing code displayed on the device screen.
- [Get terminal reader](https://docs.anny.co/developers/api-reference/internal/admin/terminal-readers/get-terminal-reader.md): Returns a single terminal reader by UUID.
- [Update terminal reader](https://docs.anny.co/developers/api-reference/internal/admin/terminal-readers/update-terminal-reader.md): Updates the reader's `label` or assigned `location`.
- [Delete terminal reader](https://docs.anny.co/developers/api-reference/internal/admin/terminal-readers/delete-terminal-reader.md): Deletes the reader from Stripe and the local database.
- [Refresh terminal reader](https://docs.anny.co/developers/api-reference/internal/admin/terminal-readers/refresh-terminal-reader.md): Fetches the latest reader state from Stripe (connectivity status, IP address, firmware version, etc.) and persists it locally.
- [Create connection token](https://docs.anny.co/developers/api-reference/internal/admin/connection-tokens/create-connection-token.md): Creates a short-lived Stripe Terminal SDK connection token.

#### Integrations & Apps

- [Bootstrap an incoming voice call](https://docs.anny.co/developers/api-reference/internal/admin/voice-integration/bootstrap-an-incoming-voice-call.md): Called by the HiDesk telephony platform when a call arrives on an anny Phone number.
- [Receive a post-call webhook from HiDesk](https://docs.anny.co/developers/api-reference/internal/admin/voice-integration/receive-a-post-call-webhook-from-hidesk.md): Sent by HiDesk after a call completes, to deliver final call status, transcript, summary, and recording link.

#### Personalization

- [Get table column config](https://docs.anny.co/developers/api-reference/internal/admin/table-configuration/get-table-column-config.md): Server-driven column catalog for an admin table: which columns the entity has, how to render each cell, and how to sort or inline-edit it. The client renders exactly the columns returned.
- [List views](https://docs.anny.co/developers/api-reference/internal/admin/views/list-views.md): Retrieve private and shared Views available to the authenticated user.
- [Create a view](https://docs.anny.co/developers/api-reference/internal/admin/views/create-a-view.md): Create a private (`owner_type=users`) or shared (`owner_type=organizations`) View.
- [Get a view](https://docs.anny.co/developers/api-reference/internal/admin/views/get-a-view.md): Retrieve a single View by UUID.
- [Update a view](https://docs.anny.co/developers/api-reference/internal/admin/views/update-a-view.md): Update view attributes.
- [Delete a view](https://docs.anny.co/developers/api-reference/internal/admin/views/delete-a-view.md): Soft-delete a View.
- [Get organization-user settings](https://docs.anny.co/developers/api-reference/internal/admin/user-settings/get-organization-user-settings.md): Retrieve the authenticated user's per-organization settings blob.
- [Update organization-user settings](https://docs.anny.co/developers/api-reference/internal/admin/user-settings/update-organization-user-settings.md): Update the authenticated user's per-organization settings.

#### Organization & Users

- [Get MCP registry config](https://docs.anny.co/developers/api-reference/internal/admin/organizations/get-mcp-registry-config.md): Returns the MCP connection bootstrap config for the active organization and requested registry.

### Identity API

- [Identity API](https://docs.anny.co/developers/api-reference/identity.md)

#### Auth

- [Get login method for a domain](https://docs.anny.co/developers/api-reference/identity/endpoints/auth/get-login-method-for-a-domain.md): Returns the login configuration for a given email domain. Use this to determine which authentication method (password, SSO, etc.) a user should use before initiating the login flow.
- [Update user profile](https://docs.anny.co/developers/api-reference/identity/endpoints/auth/update-user-profile.md): Update profile attributes for the authenticated user.
- [Request account deletion](https://docs.anny.co/developers/api-reference/identity/endpoints/auth/request-account-deletion.md): Initiates the account deletion process for the authenticated user. Sends a confirmation to the user and queues the deletion request for processing.

### Additional internal API

#### Analytics

- [Get booking analytics/preferences for the customer](https://docs.anny.co/developers/api-reference/internal/additional/analytics/get-booking-analytics-preferences-for-the-customer.md)

#### Display Panels

- [Get display panel](https://docs.anny.co/developers/api-reference/internal/additional/display-panels/get-display-panel.md): Retrieve the current state of a display panel including its configuration and active bookings. Authenticated via the panel's `secret` query parameter — no Bearer token required.
- [Update display panel](https://docs.anny.co/developers/api-reference/internal/additional/display-panels/update-display-panel.md): Update configuration attributes of a display panel. Authenticated via the panel's `secret` query parameter.
- [Register display panel](https://docs.anny.co/developers/api-reference/internal/additional/display-panels/register-display-panel.md): Register a new display panel for the organization. Returns the panel record along with a one-time pairing code and public URL used to activate the panel display.

#### Displays

- [Get a given display's configuration](https://docs.anny.co/developers/api-reference/internal/additional/displays/get-a-given-display-s-configuration.md)

#### Pairing Codes

- [Create a new pairing code](https://docs.anny.co/developers/api-reference/internal/additional/pairing-codes/create-a-new-pairing-code.md)

## OpenAPI Specs

- [customer.openapi](/developers/openapi/customer.openapi.json)
- [admin.openapi](/developers/openapi/admin.openapi.json)
- [models.openapi](/developers/openapi/models.openapi.json)
- [customer-internal.openapi](/developers/openapi/customer-internal.openapi.json)
- [admin-internal.openapi](/developers/openapi/admin-internal.openapi.json)
- [identity.openapi](/developers/openapi/identity.openapi.json)
- [additional-internal.openapi](/developers/openapi/additional-internal.openapi.json)