> ## 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 app

> Get return application data using the public return hash.



## OpenAPI

````yaml /openapi.json get /returnApp/{hash}
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:
  /returnApp/{hash}:
    get:
      tags:
        - returnApp
      summary: Get return app
      description: Get return application data using the public return hash.
      operationId: verifyReturnShipmentLink
      parameters:
        - name: hash
          in: path
          required: true
          schema:
            type: string
          description: >-
            A public access hash for accessing a resource without authentication
            (e.g., notification hash, return link hash).
      responses:
        '200':
          description: >-
            Returns return application data accessible via the public return
            hash, including return details and status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyReturnShipmentLinkResponse'
        '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:
    VerifyReturnShipmentLinkResponse:
      type: object
      properties:
        sellerId:
          type: integer
          format: int64
          description: The unique identifier for the seller
        sellerName:
          type: string
          description: The name of the seller
        defaultWeightKG:
          type: number
          description: Weight value
        weightInputVisible:
          type: boolean
          description: Weight value
        countries:
          type: array
          items:
            $ref: '#/components/schemas/ReturnAppCountry'
          description: Array of countrie items
        carrierSlug:
          uniqueItems: true
          type: array
          items:
            type: string
          description: Carrier identifier or information
        shippingServices:
          uniqueItems: true
          type: array
          items:
            type: string
          description: Service identifier or information
        sellerLogo:
          $ref: '#/components/schemas/Link'
      description: >-
        Response from verifying a return shipment link. Contains link validity
        status and associated return information.
    ReturnAppCountry:
      type: object
      properties:
        name:
          type: string
          description: The name of the item
        countryIso2:
          type: string
          description: Country code or name
        countryIso3:
          type: string
          description: Country code or name
        shipToZip:
          type: string
          enum:
            - OPTIONAL
            - REQUIRED
            - HIDDEN
          description: ZIP or postal code
        shipToState:
          type: string
          enum:
            - OPTIONAL
            - REQUIRED
            - HIDDEN
          description: State or province
      description: 'The '
    Link:
      type: object
      properties:
        link:
          type: string
          description: Link or URL reference
      description: URL link reference. Contains link URL and optional metadata.

````