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

# Retrieve a refund

> Returns one refund, for polling its status. `authorisationUrl` is always `null` here: it is returned only when the refund is created. Returns 404 if it is not on the account.



## OpenAPI

````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/refunds/{refundId}
openapi: 3.1.0
info:
  title: Roqqett API
  version: 2.0.0
  description: Version 2
  license:
    name: UNLICENSED
    url: https://docs.equalsmoney.com
servers:
  - url: https://api.equalsmoney.com/v2
    description: Production
security: []
paths:
  /roqqett/refunds/{refundId}:
    get:
      tags:
        - Refunds
      summary: Retrieve a refund
      description: >-
        Returns one refund, for polling its status. `authorisationUrl` is always
        `null` here: it is returned only when the refund is created. Returns 404
        if it is not on the account.
      operationId: findOneRefund
      parameters:
        - name: refundId
          in: path
          required: true
          schema:
            type:
              - string
            format: uuid
            maxLength: 36
            description: The ID of a refund.
            example: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45
        - name: accountId
          in: query
          schema:
            description: The ID of the account to work with.
            type:
              - string
            example: F50091
          required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  id:
                    type:
                      - string
                    format: uuid
                    maxLength: 36
                    description: The ID of a refund.
                    example: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45
                  paymentId:
                    type:
                      - string
                    format: uuid
                    maxLength: 36
                    description: The payment being refunded.
                    example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                  status:
                    type:
                      - string
                    enum:
                      - AWAITING_AUTHORISATION
                      - PENDING
                      - COMPLETED
                      - FAILED
                      - CANCELLED
                    description: >-
                      AWAITING_AUTHORISATION until the merchant authorises the
                      refund at their bank via `authorisationUrl`.
                    example: AWAITING_AUTHORISATION
                  amount:
                    type:
                      - object
                    properties:
                      amount:
                        type:
                          - string
                        maxLength: 32
                        pattern: ^[0-9]+(\.[0-9]+)?$
                        description: >-
                          Decimal amount in major units, as a string. Never a
                          float.
                        example: '10000.00'
                      currencyCode:
                        type:
                          - string
                        enum:
                          - GBP
                          - EUR
                        description: >-
                          ISO-4217 code of a currency Roqqett can take payments
                          in: GBP over Faster Payments, EUR over SEPA Instant.
                        example: GBP
                    required:
                      - amount
                      - currencyCode
                    description: >-
                      A money value: a decimal amount as a string plus an
                      ISO-4217 currency code.
                  reason:
                    type:
                      - string
                      - 'null'
                    maxLength: 140
                    description: Why the refund was made.
                    example: Item returned
                  authorisationUrl:
                    type:
                      - string
                      - 'null'
                    format: uri
                    maxLength: 2048
                    description: >-
                      The page where the merchant authorises the refund at their
                      bank: open it in a new window, then poll the refund. It
                      carries a short-lived token, so it is returned only when
                      the refund is created; retrieving a refund always returns
                      `null`.
                    example: >-
                      https://pay.roqqett.com/ob/refund?sessionId=4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45&paymentToken=example-token&organisationId=0b6f3c1e-8a2d-4f5b-9e7c-3d1a2b4c5e6f
                  createdAt:
                    type:
                      - string
                    format: date-time
                    description: >-
                      The date the Resource was initially created. ISO 8601
                      format without milliseconds.
                  completedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: When the refund reached a terminal status.
                    example: '2026-10-02T12:10:00Z'
                required:
                  - id
                  - paymentId
                  - status
                  - amount
                  - reason
                  - authorisationUrl
                  - createdAt
                  - completedAt
                example:
                  id: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45
                  paymentId: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                  status: AWAITING_AUTHORISATION
                  amount:
                    amount: '10000.00'
                    currencyCode: GBP
                  reason: Item returned
                  authorisationUrl: >-
                    https://pay.roqqett.com/ob/refund?sessionId=4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45&paymentToken=example-token&organisationId=0b6f3c1e-8a2d-4f5b-9e7c-3d1a2b4c5e6f
                  createdAt: '2019-08-24T14:15:22Z'
                  completedAt: '2026-10-02T12:10:00Z'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
      security:
        - CommonAuth:
            - roqqett:transactions:read:any
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.equalsmoney.com/v2/roqqett/refunds/{refundId}?accountId={{accountId}}' \
              --header 'Authorization: <api-key>'
components:
  securitySchemes:
    CommonAuth:
      type: apiKey
      in: header
      name: Authorization

````