> ## Documentation Index > Fetch the complete documentation index at: https://redo-44af351d-docs-return-item-identifiers-endpoint.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Import Returns > Import externally-created returns into Redo. Use this endpoint when the return originates outside of Redo — a warehouse scan, an ERP, a POS system, or a partner platform. Products are referenced by their Redo product ID, obtained from the bulk product upload response. No order is required. Returns are created ready for warehouse intake. Supports up to 100 returns per request with per-item error reporting. ## OpenAPI ````yaml /api-schema/openapi.yaml post /stores/{storeId}/returns/bulk openapi: 3.1.0 info: contact: email: engineering-admin@getredo.com name: Redo Engineering description: | ## Endpoints Endpoints are authenticated using the Bearer authorization scheme, using the REDO_API_SECRET. ```txt GET /v2.2/resource HTTP/1.1 Authorization: Bearer 77bb7598b7a972475cc7c7e171ec33af Host: api.getredo.com ``` ## Webhooks Webhooks are authenticated using the Bearer authorization scheme, using a secret supplied by the subscriber. ```txt POST /events HTTP/1.1 Authorization: Bearer subscriberauth123 Host: subscriber.example.com ``` Webhook events are delivered in order for each individual subject (e.g. return). If the response is not a 2xx status code, the event will be retried multiple times before discarding it. title: Redo API version: 2.2.1 servers: - url: https://api.getredo.com/v2.2 security: [] tags: - name: Checkout Buttons - name: Coverage Info - name: Coverage Products - name: Custom Events - name: Customer Portal - name: Customer Subscriptions - name: Customers - name: Inbound Shipments - name: Inventory Items - name: Inventory Levels - name: Invoices - name: Merchant Admin - name: Orders - name: Products - name: Returns - name: Storefront - name: Webhooks paths: /stores/{storeId}/returns/bulk: summary: Import Returns description: Import returns from external systems. parameters: - $ref: '#/components/parameters/store-id.param' post: tags: - Returns summary: Import Returns description: >- Import externally-created returns into Redo. Use this endpoint when the return originates outside of Redo — a warehouse scan, an ERP, a POS system, or a partner platform. Products are referenced by their Redo product ID, obtained from the bulk product upload response. No order is required. Returns are created ready for warehouse intake. Supports up to 100 returns per request with per-item error reporting. operationId: Import returns requestBody: content: application/json: schema: $ref: '#/components/schemas/bulk-returns-request.schema' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/bulk-returns-response.schema' description: >- Batch processed. Check individual results for per-item status. Some items may have succeeded while others failed. '400': content: application/json: schema: $ref: '#/components/schemas/error.schema' description: >- Invalid request body or team not configured for product catalog operations. default: content: application/problem+json: schema: $ref: '#/components/schemas/error.schema' description: Error security: - Bearer: [] components: parameters: store-id.param: description: Store ID in: path name: storeId required: true schema: example: 64e5a8a1af49a89df37e4ee7 type: string schemas: bulk-returns-request.schema: type: object description: Import returns request body. properties: returns: type: array minItems: 1 maxItems: 100 description: Array of returns to import (max 100). items: type: object description: A single return to import. properties: products: type: array minItems: 1 description: Products being returned (at least 1). items: type: object properties: productId: type: string description: >- Redo product ID returned from the bulk product upload response (e.g. `prd_ABC123`). quantity: type: integer minimum: 1 description: Number of units to return. sku: type: string description: Override SKU (uses catalog value if omitted). barcode: type: string description: Override barcode (uses catalog value if omitted). productTitle: type: string description: Override product title (uses catalog value if omitted). variantTitle: type: string description: Override variant title (uses catalog value if omitted). reason: type: string description: Return reason. condition: type: string description: Item condition. required: - productId - quantity customer: type: object description: Optional customer information. properties: firstName: type: string lastName: type: string email: type: string format: email externalReferenceId: type: string description: >- Merchant's own return/RMA ID. Stored on the return so it's scannable at warehouse intake. trackingNumber: type: string description: Carrier tracking number for the inbound return shipment. carrier: type: string description: Carrier name for the tracking number (e.g. 'USPS', 'UPS'). notes: type: string description: Internal notes. idempotencyKey: type: string description: Idempotency key to prevent duplicate return creation on retry. currency: type: string description: ISO 4217 currency code (defaults to USD). examples: - USD - GBP - EUR shippingAddress: type: object description: Customer's shipping address. properties: line1: type: string description: Street address line 1. line2: type: string description: Street address line 2. city: type: string description: City. state: type: string description: State or province code. postalCode: type: string description: Postal/ZIP code. country: type: string description: ISO 3166-1 alpha-2 country code. name: type: string description: Recipient or location name. phone: type: string description: Phone number. required: - line1 - city - country merchantAddress: type: object description: Merchant return destination address. properties: line1: type: string description: Street address line 1. line2: type: string description: Street address line 2. city: type: string description: City. state: type: string description: State or province code. postalCode: type: string description: Postal/ZIP code. country: type: string description: ISO 3166-1 alpha-2 country code. name: type: string description: Recipient or location name. phone: type: string description: Phone number. required: - line1 - city - country required: - products required: - returns bulk-returns-response.schema: type: object description: Bulk external return creation response. properties: totalCount: type: integer description: Total number of returns in the request. processedCount: type: integer description: Number of returns successfully created. errorCount: type: integer description: Number of returns that failed. results: type: array description: Per-item results in the same order as the request. items: oneOf: - type: object properties: status: type: string enum: - created index: type: integer description: Zero-based index into the request array. returnId: type: string description: ID of the created return. required: - status - index - returnId - type: object properties: status: type: string enum: - error index: type: integer description: Zero-based index into the request array. error: type: string description: Error message. required: - status - index - error discriminator: propertyName: status required: - totalCount - processedCount - errorCount - results error.schema: description: >- Problem details. See [RFC 7807 Section 3](https://datatracker.ietf.org/doc/html/rfc7807#section-3). properties: detail: description: Human-readable description of the problem. title: Detail type: string instance: description: A URI reference that identifies this problem. format: uri-reference type: string title: description: Human-readable summary of the problem type. title: Title type: string type: default: about:blank description: A URI reference that identifies the problem type. format: uri-reference type: string title: Problem details type: object securitySchemes: Bearer: scheme: bearer type: http ````