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

# Retrieve Cashback Information

> Returns user's OG status, GNO balance of Safe, cashback rate, and weekly spending cap.
The cashback rate is based on GNO balance tiers and includes the OG NFT holder bonus if applicable.

**Note:** This cashback structure is valid from November 1st, 2025.




## OpenAPI

````yaml https://api.gnosispay.com/api-docs/spec.json get /api/v1/cashback
openapi: 3.0.0
info:
  title: GnosisPay API
  version: 1.0.0
  description: OpenAPI documentation for GnosisPay
servers:
  - url: https://api.gnosispay.com
security: []
tags:
  - name: Account Management
    description: Information about your Account
  - name: Authentication
    description: Authenticate to our API using SIWE
  - name: Card Management
    description: Manage all your Cards
  - name: IBAN
    description: Integrate with Monerium to issue IBANs
  - name: KYC
    description: KYC using Sumsub SDK
  - name: Physical Card Order
    description: Order a Physical Card and manage the process
  - name: Rewards
    description: Cashback Rewards
  - name: Safe Management
    description: Manage your Safe
  - name: Transactions
    description: Manage Card Transactions
  - name: User
    description: Manage User Information
  - name: Webhooks
    description: Manage Webhooks
paths:
  /api/v1/cashback:
    get:
      tags:
        - Cashback
      summary: Retrieve Cashback Information
      description: >
        Returns user's OG status, GNO balance of Safe, cashback rate, and weekly
        spending cap.

        The cashback rate is based on GNO balance tiers and includes the OG NFT
        holder bonus if applicable.


        **Note:** This cashback structure is valid from November 1st, 2025.
      responses:
        '200':
          description: Successfully retrieved cashback information
          content:
            application/json:
              schema:
                type: object
                required:
                  - isOg
                  - gnoBalance
                  - cashbackRate
                  - weeklyCapUsd
                properties:
                  isOg:
                    type: boolean
                    description: >-
                      Indicates if the user holds an OG NFT token. If true, the
                      user receives higher cashback rates.
                    example: true
                  gnoBalance:
                    type: string
                    description: >-
                      User's GNO token balance in their Safe account (as string
                      to preserve precision)
                    example: '10.5'
                  cashbackRate:
                    type: number
                    description: >-
                      Cashback rate percentage (0-5%). Includes OG NFT bonus if
                      applicable.
                    example: 4
                  weeklyCapUsd:
                    type: number
                    description: >-
                      Maximum weekly spending amount eligible for cashback in
                      USD
                    example: 500
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      security:
        - bearerAuth: []
components:
  responses:
    UnauthorizedError:
      description: Unauthorized Error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````