# Stora ## Docs - [Create a Contact](https://docs.stora.co/2025-09/api-reference/contacts/create-a-contact.md): Create a new contact. - [Delete a Contact](https://docs.stora.co/2025-09/api-reference/contacts/delete-a-contact.md): Delete a contact by its ID. - [List all Contacts](https://docs.stora.co/2025-09/api-reference/contacts/list-all-contacts.md): Retrieve a list of all contacts. - [Show a Contact](https://docs.stora.co/2025-09/api-reference/contacts/show-a-contact.md): Retrieve a specific contact by its ID. - [Update a Contact](https://docs.stora.co/2025-09/api-reference/contacts/update-a-contact.md): Update an existing contact. - [List all Contract Templates](https://docs.stora.co/2025-09/api-reference/contract-templates/list-all-contract-templates.md): Retrieve a list of all contract templates. - [List all Contracts](https://docs.stora.co/2025-09/api-reference/contracts/list-all-contracts.md): Retrieve a list of all contracts. - [Show a Contract](https://docs.stora.co/2025-09/api-reference/contracts/show-a-contract.md): Retrieve a specific contract by its ID. - [List all Coupons](https://docs.stora.co/2025-09/api-reference/coupons/list-all-coupons.md): Retrieve a list of all coupons. - [Show a Coupon](https://docs.stora.co/2025-09/api-reference/coupons/show-a-coupon.md): Retrieve a specific coupon by its ID. - [List all Credit Notes](https://docs.stora.co/2025-09/api-reference/credit-notes/list-all-credit-notes.md): Retrieve a list of all credit notes. - [Show a Credit Note](https://docs.stora.co/2025-09/api-reference/credit-notes/show-a-credit-note.md): Retrieve a specific credit note by its ID. - [List all Stages](https://docs.stora.co/2025-09/api-reference/deals-stages/list-all-stages.md): Retrieve a list of all stages. - [Show a Deal Stage](https://docs.stora.co/2025-09/api-reference/deals-stages/show-a-deal-stage.md): Retrieve a specific deal stage by its ID. - [List all Deals](https://docs.stora.co/2025-09/api-reference/deals/list-all-deals.md): Retrieve a list of all deals. - [Lose a Deal](https://docs.stora.co/2025-09/api-reference/deals/lose-a-deal.md): Mark a deal as lost. - [Reopen a Deal](https://docs.stora.co/2025-09/api-reference/deals/reopen-a-deal.md): Reopen a closed deal (won or lost) and place it back on the deals board at the specified stage. - [Show a Deal](https://docs.stora.co/2025-09/api-reference/deals/show-a-deal.md): Retrieve a specific deal by its ID. - [Win a Deal](https://docs.stora.co/2025-09/api-reference/deals/win-a-deal.md): Mark a deal as won. - [List all Identity Verifications](https://docs.stora.co/2025-09/api-reference/identity-verifications/list-all-identity-verifications.md): Retrieve a list of all identity verifications. - [Show an Identity Verification](https://docs.stora.co/2025-09/api-reference/identity-verifications/show-an-identity-verification.md): Retrieve a specific identity verification by its ID. - [Get an image](https://docs.stora.co/2025-09/api-reference/images/get-an-image.md): Returns a permanent URL suitable for use in `` tags and other embedded contexts. The URL itself never expires, but when accessed it redirects to a temporary pre-signed storage URL that expires after 5 minutes. - [List all Invoices](https://docs.stora.co/2025-09/api-reference/invoices/list-all-invoices.md): Retrieve a list of all invoices. - [Show an Invoice](https://docs.stora.co/2025-09/api-reference/invoices/show-an-invoice.md): Retrieve a specific invoice by its ID. - [Create a Note](https://docs.stora.co/2025-09/api-reference/notes/create-a-note.md): Create a new note. - [Delete a Note](https://docs.stora.co/2025-09/api-reference/notes/delete-a-note.md): Delete a note by its ID. - [List all Notes](https://docs.stora.co/2025-09/api-reference/notes/list-all-notes.md): Retrieve a list of all notes. - [Show a Note](https://docs.stora.co/2025-09/api-reference/notes/show-a-note.md): Retrieve a specific note by its ID. - [Update a Note](https://docs.stora.co/2025-09/api-reference/notes/update-a-note.md): Update an existing note. - [Introspect an Access Token](https://docs.stora.co/2025-09/api-reference/oauth-2/introspect-an-access-token.md): Introspect an OAuth 2 Access Token using another Access Token. - [Retrieve an Access Token](https://docs.stora.co/2025-09/api-reference/oauth-2/retrieve-an-access-token.md): Retrieve an OAuth 2 Access Token. - [Retrieve info for the Access Token](https://docs.stora.co/2025-09/api-reference/oauth-2/retrieve-info-for-the-access-token.md): Retrieve an OAuth 2 Access Token information. - [Revoke an Access Token](https://docs.stora.co/2025-09/api-reference/oauth-2/revoke-an-access-token.md): Revoke an OAuth 2 Access Token using your Client Credentials. - [Create a Line Item](https://docs.stora.co/2025-09/api-reference/orders-line-items/create-a-line-item.md): Create a new line item for the order. Create a new line item can be done only when the order is in draft status. - [Delete a Line Item](https://docs.stora.co/2025-09/api-reference/orders-line-items/delete-a-line-item.md): Delete an existing line item. Only line items from orders in draft status can be removed. - [List all Line Items](https://docs.stora.co/2025-09/api-reference/orders-line-items/list-all-line-items.md): Retrieve a list of all line items for the order. - [Update a Line Item](https://docs.stora.co/2025-09/api-reference/orders-line-items/update-a-line-item.md): Update an existing line item. Only line items from orders in draft status can be updated. - [Create an Order](https://docs.stora.co/2025-09/api-reference/orders/create-an-order.md): Create a new order. - [Delete an Order](https://docs.stora.co/2025-09/api-reference/orders/delete-an-order.md): Delete an order by its ID. - [Finalize an Order](https://docs.stora.co/2025-09/api-reference/orders/finalize-an-order.md): Finalize an order to process it for payment. - [List all Orders](https://docs.stora.co/2025-09/api-reference/orders/list-all-orders.md): Retrieve a list of all orders. - [Show an Order](https://docs.stora.co/2025-09/api-reference/orders/show-an-order.md): Retrieve a specific order by its ID. - [Update an Order](https://docs.stora.co/2025-09/api-reference/orders/update-an-order.md): Update an existing order. - [Validate an Order](https://docs.stora.co/2025-09/api-reference/orders/validate-an-order.md): Validate an order to ensure it is ready to be finalized. - [List all Product Categories](https://docs.stora.co/2025-09/api-reference/product-categories/list-all-product-categories.md): Retrieve a list of all product categories. - [Show a Product Category](https://docs.stora.co/2025-09/api-reference/product-categories/show-a-product-category.md): Retrieve a specific product category by its ID. - [Create Base Price for the Product](https://docs.stora.co/2025-09/api-reference/products/create-base-price-for-the-product.md): Set base prices for the selected product. - [List all Products](https://docs.stora.co/2025-09/api-reference/products/list-all-products.md): Retrieve a list of all products. - [Show a Product](https://docs.stora.co/2025-09/api-reference/products/show-a-product.md): Retrieve a specific product by its ID. - [Create Base Price for the Protection Level](https://docs.stora.co/2025-09/api-reference/protection-levels/create-base-price-for-the-protection-level.md): Set base prices for the selected protection level. - [List all Protection Levels](https://docs.stora.co/2025-09/api-reference/protection-levels/list-all-protection-levels.md): Retrieve a list of all protection levels. - [Show a Protection Level](https://docs.stora.co/2025-09/api-reference/protection-levels/show-a-protection-level.md): Retrieve a specific protection level by its ID. - [List all Sites](https://docs.stora.co/2025-09/api-reference/sites/list-all-sites.md): Retrieve a list of all sites. - [Show a Site](https://docs.stora.co/2025-09/api-reference/sites/show-a-site.md): Retrieve a specific site by its ID. - [List all Staff](https://docs.stora.co/2025-09/api-reference/staff/list-all-staff.md): Retrieve a list of all staff. - [Show a Staff Member](https://docs.stora.co/2025-09/api-reference/staff/show-a-staff-member.md): Retrieve a specific staff member by its ID. - [List all Subscriptions](https://docs.stora.co/2025-09/api-reference/subscriptions/list-all-subscriptions.md): Retrieve a list of all subscriptions. - [Show a Subscription](https://docs.stora.co/2025-09/api-reference/subscriptions/show-a-subscription.md): Retrieve a specific subscription by its ID. - [Complete a Task](https://docs.stora.co/2025-09/api-reference/tasks/complete-a-task.md): Mark a task as complete. - [Create a Task](https://docs.stora.co/2025-09/api-reference/tasks/create-a-task.md): Create a new task. - [Delete a Task](https://docs.stora.co/2025-09/api-reference/tasks/delete-a-task.md): Delete a task by its ID. - [List all Tasks](https://docs.stora.co/2025-09/api-reference/tasks/list-all-tasks.md): Retrieve a list of all tasks with the correct authorization scope. - [Open a Task](https://docs.stora.co/2025-09/api-reference/tasks/open-a-task.md): Mark a task as open. - [Show a Task](https://docs.stora.co/2025-09/api-reference/tasks/show-a-task.md): Retrieve a specific task by its ID. - [Update a Task](https://docs.stora.co/2025-09/api-reference/tasks/update-a-task.md): Update an existing task. - [List all Tenancies](https://docs.stora.co/2025-09/api-reference/tenancies/list-all-tenancies.md): Retrieve a list of all tenancies. - [Show a Tenancy](https://docs.stora.co/2025-09/api-reference/tenancies/show-a-tenancy.md): Retrieve a specific tenancy by its ID. - [Create an Event](https://docs.stora.co/2025-09/api-reference/timeline-events/create-an-event.md): Create a new timeline event from an external source. - [Delete an Event](https://docs.stora.co/2025-09/api-reference/timeline-events/delete-an-event.md): Permanently delete a timeline event. - [Update an Event](https://docs.stora.co/2025-09/api-reference/timeline-events/update-an-event.md): Update an existing timeline event. - [List all Sources](https://docs.stora.co/2025-09/api-reference/timeline-sources/list-all-sources.md): Retrieve a list of all sources (both global and operator-specific). - [Show a Source](https://docs.stora.co/2025-09/api-reference/timeline-sources/show-a-source.md): Retrieve a specific source by its ID. - [List all Templates](https://docs.stora.co/2025-09/api-reference/timeline-templates/list-all-templates.md): Retrieve a list of all templates. - [Show a Template](https://docs.stora.co/2025-09/api-reference/timeline-templates/show-a-template.md): Retrieve a specific template by its ID. - [List all Unit Allocations](https://docs.stora.co/2025-09/api-reference/unit-allocations/list-all-unit-allocations.md): Retrieve a list of all unit allocations. - [Show a Unit Allocation](https://docs.stora.co/2025-09/api-reference/unit-allocations/show-a-unit-allocation.md): Retrieve a specific unit allocation by its ID. - [Create Base Price for the Unit Type](https://docs.stora.co/2025-09/api-reference/unit-types/create-base-price-for-the-unit-type.md): Set base prices for the selected unit type. - [List all Unit Types](https://docs.stora.co/2025-09/api-reference/unit-types/list-all-unit-types.md): Retrieve a list of all unit types. - [Show a Unit Type](https://docs.stora.co/2025-09/api-reference/unit-types/show-a-unit-type.md): Retrieve a specific unit type by its ID. - [Deallocate a Unit](https://docs.stora.co/2025-09/api-reference/units/deallocate-a-unit.md): Deallocate a unit. - [Grant Access to a Unit](https://docs.stora.co/2025-09/api-reference/units/grant-access-to-a-unit.md): Grant immediate access to the provided tenancy, transitioning the unit to `occupied` status. - [List all Units](https://docs.stora.co/2025-09/api-reference/units/list-all-units.md): Retrieve a list of all units. - [Overlock Units by Contact](https://docs.stora.co/2025-09/api-reference/units/overlock-units-by-contact.md): Overlock all occupied units for a contact. - [Remove Overlock from Units by Contact](https://docs.stora.co/2025-09/api-reference/units/remove-overlock-from-units-by-contact.md): Remove overlock from all overlocked units for a contact. - [Reserve a Unit](https://docs.stora.co/2025-09/api-reference/units/reserve-a-unit.md): Reserve a unit for a tenancy. - [Show a Unit](https://docs.stora.co/2025-09/api-reference/units/show-a-unit.md): Retrieve a specific unit by its ID. - [Create a Webhook Endpoint](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/create-a-webhook-endpoint.md): Create a new webhook endpoint to receive event notifications. - [Delete a Webhook Endpoint](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/delete-a-webhook-endpoint.md): Delete a webhook endpoint by its ID. - [Disable a Webhook Endpoint](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/disable-a-webhook-endpoint.md): Disable a webhook endpoint. - [Enable a Webhook Endpoint](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/enable-a-webhook-endpoint.md): Enable a webhook endpoint. - [List all Webhook Endpoints](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/list-all-webhook-endpoints.md): Retrieve a list of all webhook endpoints. - [Show a Webhook Endpoint](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/show-a-webhook-endpoint.md): Retrieve the details of a specific webhook endpoint by its ID. - [Update a Webhook Endpoint](https://docs.stora.co/2025-09/api-reference/webhook-endpoints/update-a-webhook-endpoint.md): Update an existing webhook endpoint. - [contact.created](https://docs.stora.co/2025-09/api-reference/webhooks/contactcreated.md): Triggered when a contact is created. - [contact.updated](https://docs.stora.co/2025-09/api-reference/webhooks/contactupdated.md): Triggered when the contact is updated. - [contract.created](https://docs.stora.co/2025-09/api-reference/webhooks/contractcreated.md): Triggered when a contract is created. - [contract.signed](https://docs.stora.co/2025-09/api-reference/webhooks/contractsigned.md): Triggered when a contract is signed. - [coupon.created](https://docs.stora.co/2025-09/api-reference/webhooks/couponcreated.md): Triggered when a coupon is created. - [coupon.updated](https://docs.stora.co/2025-09/api-reference/webhooks/couponupdated.md): Triggered when the coupon is updated. - [credit_note.created](https://docs.stora.co/2025-09/api-reference/webhooks/credit_notecreated.md): Triggered when a new credit is created. - [credit_note.updated](https://docs.stora.co/2025-09/api-reference/webhooks/credit_noteupdated.md): Triggered when a credit note is updated. - [deal.created](https://docs.stora.co/2025-09/api-reference/webhooks/dealcreated.md): Triggered when a deal is created. - [deal.lost](https://docs.stora.co/2025-09/api-reference/webhooks/deallost.md): Triggered when a deal is lost. - [deal.reopened](https://docs.stora.co/2025-09/api-reference/webhooks/dealreopened.md): Triggered when a deal is reopened - [deal.updated](https://docs.stora.co/2025-09/api-reference/webhooks/dealupdated.md): Triggered when a deal is updated. - [deal.won](https://docs.stora.co/2025-09/api-reference/webhooks/dealwon.md): Triggered when a deal is won. - [identity_verification.cancelled](https://docs.stora.co/2025-09/api-reference/webhooks/identity_verificationcancelled.md): Triggered when an identity verification is cancelled - [identity_verification.failed](https://docs.stora.co/2025-09/api-reference/webhooks/identity_verificationfailed.md): Triggered when an identity verification failed - [identity_verification.processing](https://docs.stora.co/2025-09/api-reference/webhooks/identity_verificationprocessing.md): Triggered when an identity verification is processing - [identity_verification.succeeded](https://docs.stora.co/2025-09/api-reference/webhooks/identity_verificationsucceeded.md): Triggered when an identity verification succeeded - [invoice.created](https://docs.stora.co/2025-09/api-reference/webhooks/invoicecreated.md): Triggered when a new invoice is created. - [invoice.finalized](https://docs.stora.co/2025-09/api-reference/webhooks/invoicefinalized.md): Triggered when an invoice is finalized. - [invoice.marked_uncollectible](https://docs.stora.co/2025-09/api-reference/webhooks/invoicemarked_uncollectible.md): Triggered when an invoice is marked as uncollectible. - [invoice.paid](https://docs.stora.co/2025-09/api-reference/webhooks/invoicepaid.md): Triggered when an invoice is mark as paid. - [invoice.updated](https://docs.stora.co/2025-09/api-reference/webhooks/invoiceupdated.md): Triggered when an invoice is updated. - [note.created](https://docs.stora.co/2025-09/api-reference/webhooks/notecreated.md): Triggered when a note is created. - [note.updated](https://docs.stora.co/2025-09/api-reference/webhooks/noteupdated.md): Triggered when a note is updated. - [order.completed](https://docs.stora.co/2025-09/api-reference/webhooks/ordercompleted.md): Triggered when the order is completed. - [order.created](https://docs.stora.co/2025-09/api-reference/webhooks/ordercreated.md): Triggered when a new order is created. - [order.finalized](https://docs.stora.co/2025-09/api-reference/webhooks/orderfinalized.md): Triggered when a new order is finalized (ready to be paid). - [protection_level.created](https://docs.stora.co/2025-09/api-reference/webhooks/protection_levelcreated.md): Triggered when a protection level is created. - [protection_level.updated](https://docs.stora.co/2025-09/api-reference/webhooks/protection_levelupdated.md): Triggered when a protection level is updated. - [subscription.cancelled](https://docs.stora.co/2025-09/api-reference/webhooks/subscriptioncancelled.md): Triggered when the subscription is cancelled. - [subscription.created](https://docs.stora.co/2025-09/api-reference/webhooks/subscriptioncreated.md): Triggered when the subscription is created. - [subscription.ended](https://docs.stora.co/2025-09/api-reference/webhooks/subscriptionended.md): Triggered when the subscription is ended. - [subscription.started](https://docs.stora.co/2025-09/api-reference/webhooks/subscriptionstarted.md): Triggered when the subscription is started. - [task.completed](https://docs.stora.co/2025-09/api-reference/webhooks/taskcompleted.md): Triggered when the task is completed. - [task.created](https://docs.stora.co/2025-09/api-reference/webhooks/taskcreated.md): Triggered when a task is created. - [task.reopened](https://docs.stora.co/2025-09/api-reference/webhooks/taskreopened.md): Triggered when a completed task is reopened. - [task.updated](https://docs.stora.co/2025-09/api-reference/webhooks/taskupdated.md): Triggered when a task is updated. - [tenancy.created](https://docs.stora.co/2025-09/api-reference/webhooks/tenancycreated.md): Triggered when a tenancy is created. - [tenancy.started](https://docs.stora.co/2025-09/api-reference/webhooks/tenancystarted.md): Triggered when the tenancy is started. - [unit_type.created](https://docs.stora.co/2025-09/api-reference/webhooks/unit_typecreated.md): Triggered when a unit type is created. - [unit_type.updated](https://docs.stora.co/2025-09/api-reference/webhooks/unit_typeupdated.md): Triggered when a unit type is updated. - [unit.available](https://docs.stora.co/2025-09/api-reference/webhooks/unitavailable.md): Triggered when a unit is made available. - [unit.created](https://docs.stora.co/2025-09/api-reference/webhooks/unitcreated.md): Triggered when a unit is created. - [unit.deallocated](https://docs.stora.co/2025-09/api-reference/webhooks/unitdeallocated.md): Triggered when a unit is deallocated. - [unit.occupied](https://docs.stora.co/2025-09/api-reference/webhooks/unitoccupied.md): Triggered when a unit is occupied. - [unit.overlocked](https://docs.stora.co/2025-09/api-reference/webhooks/unitoverlocked.md): Triggered when a unit is overlocked. - [unit.repossessed](https://docs.stora.co/2025-09/api-reference/webhooks/unitrepossessed.md): Triggered when a unit is repossessed. - [unit.reserved](https://docs.stora.co/2025-09/api-reference/webhooks/unitreserved.md): Triggered when a unit is reserved. - [unit.unavailable](https://docs.stora.co/2025-09/api-reference/webhooks/unitunavailable.md): Triggered when a unit is made unavailable. - [unit.updated](https://docs.stora.co/2025-09/api-reference/webhooks/unitupdated.md): Triggered when a unit is updated. - [Allocations and access](https://docs.stora.co/2025-09/guides/allocations-and-access.md): Understand how units are allocated to tenancies, how access is granted and restricted, and how Stora keeps third-party access control systems in sync. - [Authentication](https://docs.stora.co/2025-09/guides/authentication.md): Set up authentication with the Stora Public API using access tokens or OAuth 2.0. - [Authorization](https://docs.stora.co/2025-09/guides/authorization.md): Authorization scopes for the Stora Public API. - [Building a booking flow](https://docs.stora.co/2025-09/guides/booking-flow.md): Create a custom booking experience using the Stora API — from browsing availability to completing an order. - [Changelog](https://docs.stora.co/2025-09/guides/changelog.md): Version history for the Stora Public API. - [Core concepts](https://docs.stora.co/2025-09/guides/core-concepts.md): Understand Stora's domain model, key resources, how they relate, and the lifecycles that drive the system. - [Data synchronisation](https://docs.stora.co/2025-09/guides/data-synchronisation.md): Reduce API calls by fetching data once and using webhooks to keep your local copy current. - [Developer tools](https://docs.stora.co/2025-09/guides/developer-tools.md): Use AI tools, MCP, and machine-readable specs to work with the Stora API more efficiently. - [Errors](https://docs.stora.co/2025-09/guides/errors.md): Error codes, response format, and troubleshooting for the Stora Public API. - [Your first API call](https://docs.stora.co/2025-09/guides/first-request.md): Make your first request to the Stora Public API and explore the response. - [Introduction](https://docs.stora.co/2025-09/guides/introduction.md): Build integrations, automate workflows, and sync data with the Stora Public API. - [Resource metadata](https://docs.stora.co/2025-09/guides/metadata.md): Store arbitrary key-value pairs on resources using the metadata field. - [Building a partner integration](https://docs.stora.co/2025-09/guides/partner-integrations.md): Build integrations that work across multiple Stora operators and partner with us. - [Requests](https://docs.stora.co/2025-09/guides/requests.md): Request formats, idempotency, and rate limiting for the Stora Public API. - [Responses](https://docs.stora.co/2025-09/guides/responses.md): Response formats, expanding, pagination, and links in the Stora Public API. - [Webhooks](https://docs.stora.co/2025-09/guides/webhooks.md): Receive real-time notifications when events happen in Stora. ## OpenAPI Specs - [openapi](https://docs.stora.co/2025-09/openapi.json) Built with [Mintlify](https://mintlify.com).