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

# Get referralrewards



## OpenAPI

````yaml /openapi/openapi.yaml get /referral/rewards
openapi: 3.0.3
info:
  title: Golan Sertifikasi API
  version: 1.0.0
  description: >-
    Public REST API for Golan Sertifikasi web and mobile clients. All monetary
    values are integer IDR. Authenticate with Google ID token exchange; use the
    short-lived bearer token returned by the API.
servers:
  - url: /api/v1
security:
  - bearerAuth: []
paths:
  /referral/rewards:
    get:
      tags:
        - Finance
      operationId: listReferralRewards
      parameters:
        - name: cursor
          in: query
          schema:
            type: string
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: Referral awards earned by the authenticated user's referral code.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - next_cursor
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      required:
                        - referred_user_id
                        - amount_idr
                        - formula
                        - policy_version
                        - status
                        - reward_type
                        - created_at
                      properties:
                        topup_id:
                          type: string
                          description: Present only for legacy top-up rewards.
                        order_id:
                          type: string
                          description: Present for course-completion rewards.
                        order_item_id:
                          type: string
                          description: Present for course-completion rewards.
                        course_id:
                          type: string
                          description: Present for course-completion rewards.
                        referred_user_id:
                          type: string
                        amount_idr:
                          type: integer
                          format: int64
                        formula:
                          type: string
                          enum:
                            - fixed
                            - percentage
                        policy_version:
                          type: string
                        status:
                          type: string
                          enum:
                            - pending
                            - available
                            - reversed
                        reward_type:
                          type: string
                          enum:
                            - topup
                            - course_completion
                        created_at:
                          type: string
                          format: date-time
                  next_cursor:
                    type: string
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    Unauthorized:
      description: Authentication required.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          enum:
            - unauthorized
            - forbidden
            - invalid_google_credential
            - auth_not_configured
            - account_unavailable
            - self_referral
            - not_found
            - tax_policy_unavailable
            - finance_policy_unapproved
            - insufficient_balance
            - wallet_on_hold
            - reservation_pending
            - payment_pending
            - dependency_unavailable
            - payment_unavailable
            - push_unavailable
            - media_unavailable
            - upload_too_large
            - amount_mismatch
            - invalid_status
            - invalid_coupon
            - gateway_request_failed
            - gateway_verification_failed
            - conflict
            - invalid_request
            - idempotency_key_required
            - invalid_idempotency_key
            - internal_error
        message:
          type: string
        request_id:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.