# Teardowns.aero API

## Docs

- [Create a sales / lease / exchange](https://teardowns.aero/docs/api-reference/listings/create.md): POST a new sales / lease / exchange via the public API.
- [Delete a sales / lease / exchange](https://teardowns.aero/docs/api-reference/listings/delete.md): Hard delete removes the row + storage files.
- [Get one sales / lease / exchange](https://teardowns.aero/docs/api-reference/listings/get.md): Fetch a single sales / lease / exchange by id.
- [List sales / lease / exchanges](https://teardowns.aero/docs/api-reference/listings/list.md): Paginated list of sales / lease / exchanges owned by your organization.
- [Update a sales / lease / exchange](https://teardowns.aero/docs/api-reference/listings/update.md): Partial update on a sales / lease / exchange your org owns.
- [Create a teardown](https://teardowns.aero/docs/api-reference/teardowns/create.md): POST a new teardown via the public API.
- [Delete a teardown](https://teardowns.aero/docs/api-reference/teardowns/delete.md): Hard delete removes the row + storage files.
- [Get one teardown](https://teardowns.aero/docs/api-reference/teardowns/get.md): Fetch a single teardown by id.
- [List teardowns](https://teardowns.aero/docs/api-reference/teardowns/list.md): Paginated list of teardowns owned by your organization.
- [Transition a teardown](https://teardowns.aero/docs/api-reference/teardowns/transition.md): Move a teardown through the lifecycle state machine.
- [Update a teardown](https://teardowns.aero/docs/api-reference/teardowns/update.md): Partial update only the fields you send are applied.
- [Documents](https://teardowns.aero/docs/api-reference/uploads/listing-documents.md): Upload, set audience, and remove documents on a sales / lease / exchange listing.
- [Images](https://teardowns.aero/docs/api-reference/uploads/listing-images.md): Upload and remove images on a sales / lease / exchange listing.
- [Documents](https://teardowns.aero/docs/api-reference/uploads/teardown-documents.md): Upload, set audience, and remove documents on a teardown.
- [Images](https://teardowns.aero/docs/api-reference/uploads/teardown-images.md): Upload and remove images on a teardown.
- [Slot documents](https://teardowns.aero/docs/api-reference/uploads/teardown-slot.md): Upload and clear the four named-slot documents on a teardown (harvest list, OCCM, aircraft details, non-incident statement).
- [API keys](https://teardowns.aero/docs/concepts/api-keys.md): How keys are minted, used, rotated, and revoked.
- [Audience](https://teardowns.aero/docs/concepts/audience.md): Restricting who can see a teardown's documents.
- [Authentication](https://teardowns.aero/docs/concepts/authentication.md): The two required headers and how Teardowns.aero verifies them.
- [Errors](https://teardowns.aero/docs/concepts/errors.md): Every documented error code, what triggers it, and how to fix it.
- [Status lifecycle](https://teardowns.aero/docs/concepts/status-lifecycle.md): How teardowns move between Starting, In process, Completed, and Archived.
- [Vocabularies](https://teardowns.aero/docs/concepts/vocabularies.md): Aircraft types and engine models how to look them up and use them.

## OpenAPI Specs

- [openapi](https://teardowns.aero/docs/api-reference/openapi.json)