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

# Get Refund Request

> Retrieve a refund request by its ID.



## OpenAPI

````yaml get /v1/refund-request/{id}
openapi: 3.1.0
info:
  title: Nash API
  version: 1.0.0
servers:
  - url: https://api.sandbox.usenash.com
    description: Sandbox API
  - url: https://api.sandbox.ap-southeast-2.usenash.com
    description: Sandbox API (Australia)
  - url: https://api.usenash.com
    description: Production API
  - url: https://api.ap-southeast-2.usenash.com
    description: Production API (Australia)
security: []
tags:
  - name: Notifications
    description: Notifications
    x-nash-topic: config
  - name: Annotate
    description: Annotate
    x-nash-topic: wismo
  - name: Notifications — Send
    description: One-off notification send without a NotificationTrigger.
    x-nash-topic: notifications
  - name: Shipping
    description: Shipping operations
    x-nash-topic: shipping
  - name: Workflow
    description: Workflow automation management
    x-nash-topic: scheduling
  - name: Workflow Execution
    description: Workflow execution history and monitoring
    x-nash-topic: scheduling
  - name: Optimization Strategies
    description: Create, read, update, and delete route optimization strategies.
    x-nash-topic: scheduling
  - name: AI Agents
    description: AI agent management — create, read, update, and delete agents
    x-nash-topic: config
  - name: AI Functions
    description: LLM-backed domain tools
    x-nash-topic: ai
  - name: Webhooks
    description: Webhook delivery inspection
    x-nash-topic: webhooks
  - name: Fleet Simulator
    description: Simulate delivery status transitions in dev and sandbox environments.
    x-nash-topic: testing
  - name: Miscellaneous
    description: Miscellaneous
  - name: Job
    description: Job
    x-nash-topic: wismo
  - name: Batch Job
    description: Batch Job
    x-nash-topic: wismo
  - name: Order
    description: Order
    x-nash-topic: wismo
  - name: Route
    description: Route
    x-nash-topic: scheduling
  - name: Provider
    description: Provider
    x-nash-topic: provider
  - name: Dispatch Strategies
    description: Dispatch Strategies
    x-nash-topic: scheduling
  - name: Store Locations
    description: Store Locations
    x-nash-topic: config
  - name: Vehicles
    description: Vehicles
    x-nash-topic: provider
  - name: Couriers
    description: Couriers
    x-nash-topic: provider
  - name: Shifts
    description: Shifts
    x-nash-topic: provider
  - name: Delivery Windows
    description: Delivery Windows
    x-nash-topic: config
  - name: Templates
    description: Templates
    x-nash-topic: config
  - name: Zones
    description: Zones
    x-nash-topic: config
  - name: Feedback
    description: Feedback
    x-nash-topic: reporting
  - name: Organizations
    description: Organizations
    x-nash-topic: config
  - name: Store Catalog
    description: Store Catalog
    x-nash-topic: config
  - name: Messaging
    description: Messaging
    x-nash-topic: config
  - name: Contracts
    description: Provider contract pricing and version listings
    x-nash-topic: provider
  - name: Event Timeline
    description: Entity-scoped event timeline + outbound provider traffic for one entity.
    x-nash-topic: internal
  - name: Fleet
    description: Inbound endpoints fleets call to update in-flight deliveries.
    x-nash-topic: delivery
  - name: Route Restrictions
    description: Org-scoped geographic areas the route optimizer must avoid traversing.
    x-nash-topic: config
  - name: Users
    description: User, role, and organization-membership management.
    x-nash-topic: config
paths:
  /v1/refund-request/{id}:
    get:
      tags:
        - Job
      summary: Get Refund Request
      description: >-
        Retrieve a single refund request by its ID, including status and
        resolution details.
      operationId: get_refund_request_v1_refund_request__string_id__get
      parameters:
        - name: id
          in: path
          description: The ID of the refund request.
          required: true
          schema:
            title: Id
            type: string
            description: The ID of the refund request.
            example: rfrq_01234567890123456789
          example: rfrq_01234567890123456789
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefundRequestResponse'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NashValidationError'
components:
  schemas:
    RefundRequestResponse:
      title: RefundRequestResponse
      required:
        - id
        - createdAt
        - jobId
        - taskId
        - organizationId
        - incidentSubtype
        - incidentNotes
        - status
        - refundAmountCents
        - refundAmountDeliveryFeeCents
        - refundAmountOrderValueCents
        - refundAmountTipCents
        - currency
        - response
        - proofOfRefund
        - requestAmountCents
        - requestAmountDeliveryFeeCents
        - requestAmountOrderValueCents
        - requestAmountTipCents
      type: object
      properties:
        id:
          title: Id
          type: string
          description: The ID of the refund request.
          example: rfrq_01234567890123456789
        createdAt:
          title: Createdat
          type: string
          description: The date and time when the refund request was created.
          example: '2023-08-29T19:17:46.264523'
        resolutionDate:
          title: Resolutiondate
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The date and time when the refund request was resolved (status
            changed to approved, denied, cancelled, or nash_approved).
          default: null
          example: '2023-08-30T14:30:00.000000'
        jobId:
          title: Jobid
          type: string
          description: The job this refund request is associated with.
          example: job_01234567890123456789
        taskId:
          title: Taskid
          type: string
          description: The task this refund request is associated with.
          example: tsk_01234567890123456789
        organizationId:
          title: Organizationid
          type: string
          description: The ID of the organization.
          example: org_01234567890123456789
        incidentSubtype:
          title: Incidentsubtype
          type: string
          description: The subtype of the incident.
        incidentNotes:
          title: Incidentnotes
          type: string
          description: Notes about the incident from the merchant.
        status:
          title: Status
          anyOf:
            - $ref: '#/components/schemas/RefundStatus'
            - type: string
          description: The status of the refund request.
          example: approved
        refundAmountCents:
          title: Refundamountcents
          anyOf:
            - type: integer
            - type: 'null'
          description: The total requested refund amount.
          example: 11500
        refundAmountDeliveryFeeCents:
          title: Refundamountdeliveryfeecents
          anyOf:
            - type: integer
            - type: 'null'
          description: The requested refund amount for the delivery fee.
          example: 1000
        refundAmountOrderValueCents:
          title: Refundamountordervaluecents
          type: integer
          description: The requested refund amount for the order value.
          example: 10000
        refundAmountTipCents:
          title: Refundamounttipcents
          type: integer
          description: The requested refund amount for the tip.
          example: 500
        currency:
          title: Currency
          anyOf:
            - type: string
            - type: 'null'
          description: The currency of the refund request.
          example: USD
        response:
          title: Response
          type: string
          description: The response from the courier.
        proofOfRefund:
          title: Proofofrefund
          anyOf:
            - type: string
            - type: 'null'
          description: The supporting evidence for the refund.
        requestAmountCents:
          title: Requestamountcents
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            The request amount for the delivery fee, order value, and tip in
            cents.
          example: 11500
        requestAmountDeliveryFeeCents:
          title: Requestamountdeliveryfeecents
          anyOf:
            - type: integer
            - type: 'null'
          description: The request amount for the delivery fee in cents.
          example: 1000
        requestAmountOrderValueCents:
          title: Requestamountordervaluecents
          anyOf:
            - type: integer
            - type: 'null'
          description: The request amount for the order value in cents.
          example: 10000
        requestAmountTipCents:
          title: Requestamounttipcents
          anyOf:
            - type: integer
            - type: 'null'
          description: The request amount for the tip in cents.
          example: 500
      description: Response for refund request.
    NashValidationError:
      title: NashValidationError
      required:
        - error
        - response_status
        - RequestID
      type: object
      properties:
        error:
          $ref: '#/components/schemas/NashErrorDetails'
        response_status:
          title: Response Status
          type: string
        RequestID:
          title: Requestid
          type: string
    RefundStatus:
      title: RefundStatus
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
      type: integer
    NashErrorDetails:
      title: NashErrorDetails
      required:
        - code
        - message
      type: object
      properties:
        code:
          title: Code
          type: string
        message:
          title: Message
          type: string
        details:
          title: Details
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null

````