---
updatedAt: 2026-10-12T15:05:31.000Z
agentTools:
  projectIndex: https://wafeq.readme.io/llms.txt
---

# Retrieve revenue recognition

Endpoint for retrieving a single revenue recognition.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "CurrencyEnum": {
        "description": "An ISO 4217 currency code.\n\n[View the enum reference](currencyenum)",
        "enum": [
          "AED",
          "SAR",
          "USD",
          "EUR",
          "CAD",
          "AFN",
          "ALL",
          "AMD",
          "ARS",
          "AUD",
          "AZN",
          "BAM",
          "BDT",
          "BGN",
          "BHD",
          "BIF",
          "BND",
          "BOB",
          "BRL",
          "BWP",
          "BYN",
          "BZD",
          "CDF",
          "CHF",
          "CLP",
          "CNY",
          "COP",
          "CRC",
          "CVE",
          "CZK",
          "DJF",
          "DKK",
          "DOP",
          "DZD",
          "EGP",
          "ERN",
          "ETB",
          "GBP",
          "GEL",
          "GHS",
          "GNF",
          "GTQ",
          "HKD",
          "HNL",
          "HRK",
          "HUF",
          "IDR",
          "ILS",
          "INR",
          "IQD",
          "IRR",
          "ISK",
          "JMD",
          "JOD",
          "JPY",
          "KES",
          "KHR",
          "KMF",
          "KRW",
          "KWD",
          "KZT",
          "LBP",
          "LKR",
          "LYD",
          "MAD",
          "MDL",
          "MGA",
          "MKD",
          "MMK",
          "MOP",
          "MUR",
          "MXN",
          "MYR",
          "MZN",
          "NAD",
          "NGN",
          "NIO",
          "NOK",
          "NPR",
          "NZD",
          "OMR",
          "PAB",
          "PEN",
          "PHP",
          "PKR",
          "PLN",
          "PYG",
          "QAR",
          "RON",
          "RSD",
          "RUB",
          "RWF",
          "SDG",
          "SEK",
          "SGD",
          "SOS",
          "SYP",
          "THB",
          "TND",
          "TOP",
          "TRY",
          "TTD",
          "TWD",
          "TZS",
          "UAH",
          "UGX",
          "UYU",
          "UZS",
          "VES",
          "VND",
          "XAF",
          "XOF",
          "YER",
          "ZAR",
          "ZMW"
        ],
        "type": "string"
      },
      "DurationEnum": {
        "description": "Duration over which an amount is recognized or amortized.\n\n[View the enum reference](durationenum)",
        "enum": [
          "3_MONTHS",
          "4_MONTHS",
          "6_MONTHS",
          "12_MONTHS",
          "24_MONTHS",
          "CUSTOM"
        ],
        "type": "string"
      },
      "RecognitionTypeEnum": {
        "description": "Schedule used to recognize deferred amounts.\n\n[View the enum reference](recognitiontypeenum)",
        "enum": [
          "DAILY",
          "MONTHLY"
        ],
        "type": "string"
      },
      "RevenueRecognitionStatusEnum": {
        "description": "The current lifecycle status of a revenue recognition schedule.\n\n[View the enum reference](revenuerecognitionstatusenum)",
        "enum": [
          "DRAFT",
          "ENDED_EARLY",
          "FULLY_RECOGNIZED",
          "INACTIVE",
          "RECOGNIZING",
          "SCHEDULED"
        ],
        "type": "string"
      },
      "api-v1-revenue-recognition": {
        "description": "A revenue recognition schedule that spreads an invoice line item amount over time as revenue.",
        "properties": {
          "account": {
            "description": "The revenue account used for revenue recognition.",
            "readOnly": true,
            "type": "string"
          },
          "amount": {
            "description": "The total amount being recognized.",
            "exclusiveMaximum": 10000000000000000,
            "exclusiveMinimum": -10000000000000000,
            "format": "double",
            "readOnly": true,
            "type": "number"
          },
          "balance": {
            "description": "The remaining un-recognized balance.",
            "exclusiveMaximum": 10000000000000000,
            "exclusiveMinimum": -10000000000000000,
            "format": "double",
            "readOnly": true,
            "type": [
              "number",
              "null"
            ]
          },
          "created_ts": {
            "description": "The timestamp in UTC when the revenue recognition was created.",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "currency": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CurrencyEnum"
              }
            ],
            "description": "The currency of the revenue recognition.\n\n[View the enum reference](currencyenum)",
            "readOnly": true
          },
          "description": {
            "description": "The description of the revenue recognition.",
            "readOnly": true,
            "type": "string"
          },
          "duration": {
            "allOf": [
              {
                "$ref": "#/components/schemas/DurationEnum"
              }
            ],
            "description": "The recognition duration (e.g. 3_MONTHS, 12_MONTHS, CUSTOM).\n\n[View the enum reference](durationenum)",
            "readOnly": true
          },
          "end_date": {
            "description": "The end date of the revenue recognition schedule.",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "end_early_account": {
            "description": "The revenue account used to recognize the early termination, if any.",
            "readOnly": true,
            "type": "string"
          },
          "end_early_date": {
            "description": "The date when the revenue recognition was terminated early, if applicable.",
            "format": "date",
            "readOnly": true,
            "type": [
              "string",
              "null"
            ]
          },
          "end_early_ts": {
            "description": "The timestamp in UTC when the revenue recognition was terminated early, if applicable.",
            "format": "date-time",
            "readOnly": true,
            "type": [
              "string",
              "null"
            ]
          },
          "events": {
            "description": "The list of revenue recognition events generated by this revenue recognition.",
            "items": {
              "$ref": "#/components/schemas/api-v1-revenue-recognition-event"
            },
            "readOnly": true,
            "type": "array"
          },
          "id": {
            "description": "The unique identifier of the revenue recognition.",
            "readOnly": true,
            "type": "string"
          },
          "invoice": {
            "description": "The invoice that this revenue recognition belongs to.",
            "readOnly": true,
            "type": "string"
          },
          "legacy_id": {
            "description": "[Deprecated] The legacy identifier of the revenue recognition.",
            "readOnly": true,
            "type": "string"
          },
          "modified_ts": {
            "description": "The timestamp in UTC when the revenue recognition was last modified.",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "notes": {
            "description": "Free-form notes about the revenue recognition.",
            "readOnly": true,
            "type": "string"
          },
          "recognition_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RecognitionTypeEnum"
              }
            ],
            "description": "How the revenue recognition is recognized (DAILY or MONTHLY).\n\n[View the enum reference](recognitiontypeenum)",
            "readOnly": true
          },
          "start_date": {
            "description": "The start date of the revenue recognition schedule.",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RevenueRecognitionStatusEnum"
              }
            ],
            "description": "The current status of the revenue recognition.\n\n[View the enum reference](revenuerecognitionstatusenum)",
            "readOnly": true
          },
          "use_entity_date": {
            "description": "Whether the revenue recognition start date follows the invoice date.",
            "readOnly": true,
            "type": "boolean"
          }
        },
        "required": [
          "account",
          "amount",
          "balance",
          "created_ts",
          "currency",
          "description",
          "duration",
          "end_date",
          "end_early_account",
          "end_early_date",
          "end_early_ts",
          "events",
          "id",
          "invoice",
          "legacy_id",
          "modified_ts",
          "notes",
          "recognition_type",
          "start_date",
          "status",
          "use_entity_date"
        ],
        "type": "object"
      },
      "api-v1-revenue-recognition-event": {
        "description": "A scheduled or posted event that recognizes part of a deferred invoice amount as revenue.",
        "properties": {
          "amount": {
            "description": "The amount recognized for this event.",
            "exclusiveMaximum": 10000000000000000,
            "exclusiveMinimum": -10000000000000000,
            "format": "double",
            "readOnly": true,
            "type": "number"
          },
          "amount_to_bcy": {
            "description": "The amount converted to the organization base currency.",
            "exclusiveMaximum": 10000000000000000,
            "exclusiveMinimum": -10000000000000000,
            "format": "double",
            "readOnly": true,
            "type": [
              "number",
              "null"
            ]
          },
          "balance": {
            "description": "The remaining balance after this event.",
            "exclusiveMaximum": 10000000000000000,
            "exclusiveMinimum": -10000000000000000,
            "format": "double",
            "readOnly": true,
            "type": "number"
          },
          "date": {
            "description": "The date when this event is recognized.",
            "format": "date",
            "readOnly": true,
            "type": "string"
          },
          "description": {
            "description": "The description of the event.",
            "readOnly": true,
            "type": "string"
          },
          "id": {
            "description": "The unique identifier of the revenue recognition event.",
            "readOnly": true,
            "type": "string"
          },
          "journal": {
            "description": "The journal entry generated by this revenue recognition event, if posted.",
            "readOnly": true,
            "type": [
              "string",
              "null"
            ]
          },
          "legacy_id": {
            "description": "[Deprecated] The legacy identifier of the revenue recognition event.",
            "readOnly": true,
            "type": "string"
          }
        },
        "required": [
          "amount",
          "amount_to_bcy",
          "balance",
          "date",
          "description",
          "id",
          "journal",
          "legacy_id"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "APIKeyAuth": {
        "description": "__An API key that will be supplied in  `Authorization` header.__\n\nExample:\n`Api-Key vVLOU1BB.aKz8GWaAGz0w1fO997aCMskNfS0ZpwjS`",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey",
        "x-default": "Api-Key replace_with_your_api_key"
      }
    }
  },
  "info": {
    "title": "Wafeq Public API",
    "version": "v1"
  },
  "openapi": "3.1.1",
  "paths": {
    "/revenue-recognitions/{id}/": {
      "get": {
        "description": "Endpoint for retrieving a single revenue recognition.",
        "operationId": "revenue_recognitions_retrieve",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/api-v1-revenue-recognition"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "APIKeyAuth": []
          }
        ],
        "summary": "Retrieve revenue recognition",
        "tags": [
          "Revenue Recognitions"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "Wafeq API Base URL",
      "url": "https://api.wafeq.com/v1"
    }
  ],
  "x-readme": {
    "proxy-enabled": false,
    "samples-languages": [
      "shell",
      "http"
    ]
  }
}
```