> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.quivo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get return shipment

> Get single return shipment by its ID.



## OpenAPI

````yaml /openapi.json get /returns/{returnShipmentId}
openapi: 3.0.1
info:
  title: Connector
  version: 80f7edc, 2026-01-23T12:01:00Z
  description: Enhanced Quivo API documentation with additional descriptions and examples
  contact:
    name: Quivo Support
    email: support@quivo.co
    url: https://quivo.co
  license:
    name: Proprietary
    url: https://quivo.co/terms
  termsOfService: https://quivo.co/terms
servers:
  - url: https://api.quivo.co/
    description: Production API server for Quivo Connector
security: []
tags:
  - name: addresses
    description: Manage stored addresses in the seller's address book
  - name: apiKeyRequests
    description: Request and manage API keys
  - name: articles
    description: Create and manage product articles
  - name: audits
    description: Access audit logs and history
  - name: bundles
    description: Manage product bundles
  - name: carriers
    description: Get carrier information
  - name: contacts
    description: Manage contact information
  - name: countries
    description: Get country information
  - name: currencies
    description: Get currency information
  - name: customerInquiries
    description: Manage customer inquiries
  - name: dashboards
    description: Access dashboard data
  - name: files
    description: Manage file uploads and downloads
  - name: fulfillmentPlans
    description: Manage fulfillment plans
  - name: inbounds
    description: Manage inbound shipments
  - name: items
    description: Monitor and manage inventory items
  - name: languages
    description: Get language information
  - name: notifications
    description: Manage notifications
  - name: orders
    description: Create and manage fulfillment orders
  - name: ping
    description: Health check endpoint
  - name: returnApp
    description: Manage return applications
  - name: returnLinks
    description: Manage return links
  - name: returns
    description: Manage returns
  - name: sellers
    description: Get seller information
  - name: shipments
    description: Book and manage shipments
  - name: shippingServiceGroups
    description: Get shipping service groups
  - name: shopOrders
    description: Manage shop orders
  - name: shops
    description: Manage shops
  - name: status
    description: Get system status
  - name: storedAddresses
    description: Manage stored addresses
  - name: subscriptionPackages
    description: Manage subscription packages
  - name: subscriptions
    description: Manage webhook subscriptions
  - name: track
    description: Track shipments
  - name: transports
    description: Manage transport services
  - name: users
    description: Manage users
  - name: warehouses
    description: Get warehouse information
paths:
  /returns/{returnShipmentId}:
    get:
      tags:
        - returns
      summary: Get return shipment
      description: Get single return shipment by its ID.
      operationId: returnGetReturn
      parameters:
        - name: returnShipmentId
          in: path
          required: true
          schema:
            type: integer
            format: int64
          description: The unique identifier for a return shipment.
      responses:
        '200':
          description: >-
            Returns the return shipment details including items and current
            status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReturnShipmentDetail'
        '400':
          description: >-
            Bad request - the request payload is invalid, missing required
            fields, or contains invalid data.
        '401':
          description: >-
            Unauthorized - authentication credentials are missing, invalid, or
            expired.
        '404':
          description: >-
            Not found - the requested resource does not exist or is not
            accessible.
        '500':
          description: Internal server error - an unexpected error occurred on the server.
components:
  schemas:
    ReturnShipmentDetail:
      type: object
      properties:
        returnShipmentId:
          type: integer
          format: int64
          description: The unique identifier for the returnshipment
        warehouseId:
          type: integer
          format: int64
          description: The unique identifier for the warehouse
        returnShipmentIdentifier:
          type: string
          description: The unique identifier for the returnshipmententifier
        sellerId:
          type: integer
          format: int64
          description: The unique identifier for the seller
        receivedDate:
          type: string
          format: date-time
          description: The received date date
        trackingNumber:
          type: string
          description: Tracking information or tracking enabled status
        trackingLink:
          type: string
          description: Tracking information or tracking enabled status
        carrierSlug:
          type: string
          description: Carrier identifier or information
        orderId:
          type: integer
          format: int64
          description: The unique identifier for the order
        fulfillmentOrderId:
          type: integer
          format: int64
          description: The unique identifier for the fulfillmentorder
        returnAnnouncementId:
          type: integer
          format: int64
          description: The unique identifier for the returnannouncement
        shipFrom:
          $ref: '#/components/schemas/AddressDetail'
        returnShipmentReference:
          type: string
          description: Reference number or identifier for the return shipment
        customerExamined:
          type: boolean
          description: Customer identifier or information
        positions:
          type: array
          items:
            $ref: '#/components/schemas/ReturnShipmentPositionDetail'
          description: Array of position items
        groupedPositions:
          type: array
          items:
            $ref: '#/components/schemas/GroupedReturnShipmentPositionDetail'
          description: Array of grouped position
        comments:
          type: array
          items:
            $ref: '#/components/schemas/ReturnShipmentCommentDetail'
          description: Comment or notes
        piiDataRemoved:
          type: boolean
          description: Boolean flag indicating pii data removed
      description: >-
        Complete return shipment information with all details. Contains return
        identifiers, original order reference, return reason, status, and
        processing information.
    AddressDetail:
      type: object
      properties:
        name1:
          type: string
          description: The name of the item
        name2:
          type: string
          description: The name of the item
        company:
          type: string
          description: Company name
        address1:
          type: string
          description: Address information
        address2:
          type: string
          description: Address information
        address3:
          type: string
          description: Address information
        zip:
          type: string
          description: ZIP or postal code
        city:
          type: string
          description: City name
        state:
          type: string
          description: State or province
        country:
          type: string
          description: Country code or name
        phone:
          type: string
          description: Phone number
        email:
          type: string
          description: Email address
      description: Detailed address information
    ReturnShipmentPositionDetail:
      type: object
      properties:
        returnShipmentPositionId:
          type: integer
          format: int64
          description: The unique identifier for the returnshipmentposition
        sellerSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        name:
          type: string
          description: The name of the item
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        lot:
          type: string
          description: The lot value
        expirationDate:
          type: string
          format: date-time
          description: The expiration date date
        serialNumbers:
          type: array
          items:
            type: string
          description: Number value
        classCode:
          type: string
          description: Code or identifier
        classDescription:
          type: string
          description: Description text
        reasonCode:
          type: string
          description: Code or identifier
        reasonDescription:
          type: string
          description: Description text
        positionIdentifier:
          type: string
          description: The unique identifier for the positionentifier
        storageCode:
          type: string
          description: Code or identifier
        storageBlocked:
          type: boolean
          description: Boolean flag indicating storage blocked
      description: Detailed information for returnshipmentposition
    GroupedReturnShipmentPositionDetail:
      type: object
      properties:
        sellerSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        name:
          type: string
          description: The name of the item
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        lot:
          type: string
          description: The lot value
        expirationDate:
          type: string
          format: date-time
          description: The expiration date date
        serialNumbers:
          type: array
          items:
            type: string
          description: Number value
        classCode:
          type: string
          description: Code or identifier
        classDescription:
          type: string
          description: Description text
        reasonCode:
          type: string
          description: Code or identifier
        reasonDescription:
          type: string
          description: Description text
      description: Detailed information for groupedreturnshipmentposition
    ReturnShipmentCommentDetail:
      type: object
      properties:
        returnShipmentCommentId:
          type: integer
          format: int64
          description: The unique identifier for the returnshipmentcomment
        text:
          type: string
          description: The text value
        fileKey:
          type: string
          description: Key or identifier
        url:
          $ref: '#/components/schemas/Link'
        returnShipmentImages:
          type: array
          items:
            $ref: '#/components/schemas/ReturnShipmentImageDetail'
          description: Image reference
      description: Detailed information for returnshipmentcomment
    Link:
      type: object
      properties:
        link:
          type: string
          description: Link or URL reference
      description: URL link reference. Contains link URL and optional metadata.
    ReturnShipmentImageDetail:
      type: object
      properties:
        text:
          type: string
          description: The text value
        fileKey:
          type: string
          description: Key or identifier
        url:
          $ref: '#/components/schemas/Link'
      description: Detailed information for returnshipmentimage

````