> ## Documentation Index > Fetch the complete documentation index at: https://api.monument.io/llms.txt > Use this file to discover all available pages before exploring further. # Get auctions by UUIDs > Retrieves auction details for the provided array of UUIDs, most recently updated first. ## OpenAPI ````yaml /openapi/integration-openapi.json post /api/{portfolio}/portfolios/v1/facilities/{facilityUuid}/auctions/get_by_uuids openapi: 3.0.0 info: title: Monument Integration API description: Monument Integration API version: '1.0' contact: {} servers: - url: https://public-api.prd.monument.io description: Production - url: https://public-api.stg.monument.io description: Staging security: [] tags: - name: Portfolios description: List portfolios accessible to the API key - name: Facilities description: Facility retrieval and coverage-option configuration - name: Units description: Unit listing and MORA execution - name: Unit Groups description: Unit group listing, rate management, and unit assignment - name: Rental Records description: Rental record listing, coverage, fees, autopay, and payment links - name: Ledger Entries description: Ledger entry retrieval at facility and rental-record level - name: Leads description: Lead listing and lease sending - name: Tasks description: Task creation and listing for integrations - name: Tenants description: Tenant listing and person updates - name: People description: Person listing - name: Notes description: Note listing and creation for tenants and leads - name: Auctions description: Auction listing - name: Coverage description: Portfolio-level coverage CRUD and coverage history - name: Summary description: Portfolio-level aggregate summaries (insurance enrollment/occupancy) - name: Promotions description: Promotion listing - name: ECRI description: Effective Current Rent Increase scheduling - name: Item Types description: Item type listing per facility - name: Delinquencies description: Delinquency listing per facility - name: Physical Locks description: Physical lock assignment and unassignment - name: Lead Source Options description: Lead source option listing - name: Webhooks description: Webhook subscription management - name: Payments description: Payment profile creation paths: /api/{portfolio}/portfolios/v1/facilities/{facilityUuid}/auctions/get_by_uuids: post: tags: - Auctions summary: Get auctions by UUIDs description: >- Retrieves auction details for the provided array of UUIDs, most recently updated first. operationId: PrivateApiAuctionController_getAuctionsByUuids parameters: - name: facilityUuid required: true in: path schema: type: string format: uuid - in: path required: true name: portfolio schema: example: abc_selfstorage - in: header required: true name: x-api-key schema: example: monument-2230012-2312321 description: >- Api key required to authenticate your request. Please reach out to monument for a key. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetAuctionsByUuidsRequestDto' responses: '200': description: Auction details retrieved successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/AuctionDetailsByUuidsResponseDto' '400': description: Too many uuids components: schemas: GetAuctionsByUuidsRequestDto: type: object properties: auctionUuids: description: Array of auction UUIDs to retrieve (max 1000) example: - 123e4567-e89b-12d3-a456-426614174000 type: array items: type: string required: - auctionUuids AuctionDetailsByUuidsResponseDto: type: object properties: auctionUuid: type: string description: Auction UUID format: uuid example: 123e4567-e89b-12d3-a456-426614174000 auctionStage: type: string description: Auction stage enum: - NOT_SCHEDULED - SCHEDULED - PAYMENT_PENDING - WAITING_FOR_CLEAN_OUT - COMPLETED - CANCELED - UNSOLD example: SCHEDULED auctionStartDate: format: date-time type: string nullable: true description: Auction start date example: '2024-01-15T10:00:00.000Z' auctionEndDate: format: date-time type: string nullable: true description: Auction end date example: '2024-01-15T18:00:00.000Z' minimumBidAmount: type: number nullable: true description: Minimum bid amount example: 100 winningBidAmount: type: number nullable: true description: Winning bid amount example: 250 buyerName: type: string nullable: true description: Buyer name example: John Doe buyerEmail: type: string nullable: true description: Buyer email example: buyer@example.com buyerPhone: type: string nullable: true description: Buyer phone example: '5551234567' auctionScheduledOnDate: format: date-time type: string nullable: true description: Date auction was scheduled example: '2024-01-10T00:00:00.000Z' auctionCompletedOnDate: format: date-time type: string nullable: true description: Date auction was completed example: '2024-01-16T00:00:00.000Z' auctionCanceledOnDate: format: date-time type: string nullable: true description: Date auction was canceled example: '2024-01-14T00:00:00.000Z' cleanOutDate: format: date-time type: string nullable: true description: Clean out date example: '2024-01-20T00:00:00.000Z' unitRentalRecordUuid: type: string description: Unit rental record UUID format: uuid example: 123e4567-e89b-12d3-a456-426614174000 contentCategories: description: Content category descriptions example: - Furniture - Electronics type: array items: type: string content: type: string nullable: true description: Contents description example: Household items and boxes photos: description: Auction photos type: array items: $ref: '#/components/schemas/AuctionPhotoResponseDto' tamperTagId: type: string nullable: true description: Tamper tag ID example: TAG-12345 requiresNotice: type: boolean description: Whether the auction requires public notice example: false required: - auctionUuid - auctionStage - auctionStartDate - auctionEndDate - minimumBidAmount - winningBidAmount - buyerName - buyerEmail - buyerPhone - auctionScheduledOnDate - auctionCompletedOnDate - auctionCanceledOnDate - cleanOutDate - unitRentalRecordUuid - contentCategories - content - photos - tamperTagId - requiresNotice AuctionPhotoResponseDto: type: object properties: url: type: string description: Photo CDN URL example: >- https://communication-media.cdn.production.monument.io/auctions/photo1.jpg isPrimary: type: boolean description: Whether this is the primary photo example: true photoType: type: string description: Photo type enum: - UNIT_CONTENTS - TAMPER_TAG - CLEAN_OUT example: UNIT_CONTENTS required: - url - isPrimary - photoType ````