> ## Documentation Index > Fetch the complete documentation index at: https://developer.firstbasedev.com/llms.txt > Use this file to discover all available pages before exploring further. # List ITAD requests > Returns a paginated list of ITAD (IT Asset Disposition) requests for the organization. Each request represents a scheduled disposition event for one or more inventory items. Use query parameters to filter by status or date range. ## OpenAPI ````yaml /openapi.json get /api/v1/itad/requests openapi: 3.1.0 info: title: Firstbase API Specification Beta description: Integration endpoints for Firstbase version: 0.1.0 servers: - url: / description: Default security: - ApiKey: [] tags: - name: Inventory Orders description: Create and manage inventory orders - name: Shipment Notices V1 description: 'Query shipment notice orders (V1: package items expose `inventories` list)' - name: Packages description: '' - name: Categories description: Query available categories for asset creation - name: Catalog description: '' - name: New Joiners description: New joiner provisioning pipeline for the organization - name: Orders description: '' - name: People description: >- Manage the users of Firstbase for your organization. API follows the SCIM standard. externalDocs: url: https://scim.cloud/ - name: People — Lifecycle description: Offboard and reactivate users. - name: Assets description: Manage inventory assets - name: Regions V1 description: Query regions (V1) - name: Warehouses V1 description: Query warehouses (V1) - name: Brands description: Query available brands for asset creation - name: Inventory description: '' - name: Replacements description: Create and manage equipment replacements - name: Offices description: Manage and query office locations for the authenticated organization - name: Returns description: Return and Replacements paths: /api/v1/itad/requests: get: tags: - ITAD summary: List ITAD requests description: >- Returns a paginated list of ITAD (IT Asset Disposition) requests for the organization. Each request represents a scheduled disposition event for one or more inventory items. Use query parameters to filter by status or date range. operationId: listITADRequests parameters: - name: page in: query description: Page number (1-based) required: false allowEmptyValue: true schema: type: integer format: int32 default: 1 example: 1 - name: size in: query description: Number of results per page required: false allowEmptyValue: true schema: type: integer format: int32 default: 25 maximum: 100 example: 25 - name: status in: query description: Filter by request status required: false allowEmptyValue: true schema: type: string enum: - PENDING_DATA_DESTRUCTION - REQUIRES_ACTION - AWAITING_RECHECK - PENDING_SETTLEMENT - COMPLETED - CANCELLED - name: warehouseId in: query description: Filter by warehouse ID required: false allowEmptyValue: true schema: type: string format: uuid example: 00000000-0000-0000-0000-000000000000 responses: '200': description: Paginated list of ITAD requests content: application/json: schema: type: array items: $ref: '#/components/schemas/ITADRequest' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/PublicApiHttpErrors' '404': description: Not Found content: '*/*': schema: $ref: '#/components/schemas/PublicApiHttpErrors' '409': description: Conflict content: '*/*': schema: $ref: '#/components/schemas/PublicApiHttpErrors' components: schemas: ITADRequest: type: object description: An ITAD (IT Asset Disposition) request properties: id: type: string format: uuid description: Unique request ID example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 status: type: string description: Current request status enum: - PENDING_DATA_DESTRUCTION - REQUIRES_ACTION - AWAITING_RECHECK - PENDING_SETTLEMENT - COMPLETED - CANCELLED example: PENDING_DATA_DESTRUCTION createdAt: type: string format: date-time description: Timestamp when the request was created completedAt: type: string format: date-time description: Timestamp when the request was completed cancelledAt: type: string format: date-time description: Timestamp when the request was cancelled totalEstimatedResaleValue: type: number description: Total estimated resale value of all items example: 2500 totalResaleValue: type: number description: Total actual resale value of all items example: 2300 submittedVia: type: string description: How the request was submitted enum: - ASSETS_PAGE - ITAD_CENTER - RETURN example: ITAD_CENTER createdByActor: type: string description: Actor who created the request enum: - CUSTOMER - OPS example: CUSTOMER warehouseId: type: string format: uuid description: ID of the warehouse example: ecb7e933-de1e-9830-b180-b25d1d0d296e warehouseName: type: string description: Name of the warehouse example: US East Warehouse organizationId: type: string format: uuid description: ID of the organization example: ecb7e933-de1e-9830-b180-b25d1d0d296e organizationName: type: string description: Name of the organization example: Acme Corp createdById: type: string format: uuid description: ID of the person who created the request example: ecb7e933-de1e-9830-b180-b25d1d0d296e createdByName: type: string description: Name of the person who created the request example: John Doe lotCodDocumentId: type: string format: uuid description: Lot Certificate of Destruction document ID lotCodUploadedAt: type: string format: date-time description: Timestamp when the lot CoD was uploaded settlementReportDocumentId: type: string format: uuid description: Settlement report document ID settlementReportGeneratedAt: type: string format: date-time description: Timestamp when the settlement report was generated parentItadRequestId: type: string format: uuid description: Parent ITAD request ID for multi-warehouse bulk submissions items: type: array description: Items in this request (included in detail responses only) items: $ref: '#/components/schemas/ITADRequestItem' required: - createdByActor - id - status - submittedVia PublicApiHttpErrors: type: object properties: errors: type: array items: $ref: '#/components/schemas/PublicApiError' required: - errors ITADRequestItem: type: object description: An item within an ITAD request properties: id: type: string format: uuid description: Unique item ID example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 inventoryId: type: string format: uuid description: ID of the inventory asset example: ecb7e933-de1e-9830-b180-b25d1d0d296e serialNumber: type: string description: Serial number of the asset example: C02X1234ABCD skuTitle: type: string description: Product title of the SKU example: MacBook Pro 14" M2 categoryCode: type: string description: Category code of the SKU example: COMPUTER estimatedResaleValue: type: number description: Estimated resale value example: 450 resaleValue: type: number description: Actual resale value example: 420 estimatedMaxCreditValueAtRequest: type: number description: Estimated max credit value at time of request example: 500 rmsStatus: type: string description: RMS enrollment status enum: - NOT_ENROLLED - UNENROLLMENT_REQUIRED - AWAITING_RECHECK - CLEARED example: NOT_ENROLLED status: type: string description: Item status enum: - PENDING - ENQUEUED - DATA_DESTRUCTION_COMPLETED - SETTLED - CANCELLED example: PENDING settledAmount: type: number description: Settled amount after disposition example: 400 grossSaleAmount: type: number description: Gross sale amount example: 410 currencyCode: type: string description: Currency code for monetary values example: USD cancelledAt: type: string format: date-time description: Timestamp when the item was cancelled required: - id PublicApiError: type: object properties: detail: type: string description: Human-readable description of the error example: Invalid request source: type: string description: >- Entity or field path that caused the error (for example order, shipmentNotice, or person:email) example: request required: - detail - source securitySchemes: ApiKey: type: apiKey description: Prefix the value with "ApiKey" to indicate the custom authorization type name: Authorization in: header ````