> ## Documentation Index > Fetch the complete documentation index at: https://docs.engine.usesophic.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Account Returns (MWRR / TWRR) > Retrieve the account's MWRR and TWRR for the requested period. ## OpenAPI ````yaml /openapi.json get /accounts/{account_id}/returns openapi: 3.1.0 info: title: Sophic Engine API version: 0.1.0 servers: - url: https://api.engine.usesophic.com security: [] tags: - description: Retrieve accounts, statements, and account documents. name: accounts x-group: Accounts - description: Read the audit trail of platform activity. name: activity x-group: Activity - description: Obtain OAuth access tokens for the Engine API. name: auth x-group: Authentication - description: Inspect the authenticated user or service actor. name: identity x-group: Identity - description: Retrieve fee schedules and billing information. name: billing x-group: Billing - description: Browse instruments and tradable products. name: catalog x-group: Catalog - description: Track onboarding applications through completion. name: onboarding x-group: Onboarding - description: Manage customer records and related person data. name: customers x-group: Customers - description: List platform events and inspect individual occurrences. name: events x-group: Events - description: Read positions, transactions, and account holdings. name: holdings x-group: Holdings - description: Retrieve legal agreements and required disclosures. name: legal-documents x-group: Legal Documents - description: Access prices and market data for instruments. name: market-data x-group: Market Data - description: Manage deposits, withdrawals, and funding accounts. name: payments x-group: Payments - description: Retrieve returns, earnings, and performance metrics. name: performance x-group: Performance - description: Place and manage orders, quotes, and trades. name: trading x-group: Trading - description: Read position and account valuations over time. name: valuation x-group: Valuation - description: Configure webhook endpoints and inspect deliveries. name: webhooks x-group: Webhooks - description: Upload files and retrieve stored documents. name: files x-group: Files paths: /accounts/{account_id}/returns: get: tags: - performance summary: Retrieve Account Returns (MWRR / TWRR) description: Retrieve the account's MWRR and TWRR for the requested period. operationId: get_account_returns_accounts__account_id__returns_get parameters: - in: path name: account_id required: true schema: title: Account Id type: string - description: Predefined period over which returns are computed. in: query name: period required: true schema: allOf: - $ref: '#/components/schemas/Period' description: Predefined period over which returns are computed. title: Period responses: '200': content: application/json: schema: $ref: '#/components/schemas/AccountReturns' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request security: - HTTPBearer: [] components: schemas: Period: enum: - 1d - 1w - 1m - this-month - 3m - 6m - ytd - 1y - all properties: {} title: Period type: string AccountReturns: properties: account: description: ID of the account the returns were computed for. title: Account type: string flags: description: Signals explaining clamps, missing data, or uncomputable rates. items: $ref: '#/components/schemas/ReturnsFlag' title: Flags type: array mwrr: anyOf: - type: string - type: 'null' description: >- Cumulative money-weighted rate of return as a decimal; `null` when uncomputable. examples: - '0.0925' title: Mwrr period: allOf: - $ref: '#/components/schemas/Period' description: Requested period the returns were computed over. period_end: description: Resolved end of the period (the `asof` time of the computation). examples: - '2026-07-14T09:34:12Z' format: date-time title: Period End type: string period_start: description: >- Resolved start of the period, inclusive. Clamped to the scope's inception when the requested period starts earlier. examples: - '2026-01-01T00:00:00Z' format: date-time title: Period Start type: string twrr: anyOf: - type: string - type: 'null' description: >- Cumulative time-weighted rate of return as a decimal; `null` when uncomputable. examples: - '0.0875' title: Twrr required: - period - period_start - period_end - mwrr - twrr - flags - account title: AccountReturns type: object Error: properties: code: description: A machine-readable error code. title: Code type: string context: additionalProperties: anyOf: - type: string - type: integer description: An optional object for adding extra context to the error. title: Context type: object x-remove-null-from-type-union: true detail: description: A human-readable description of the error. title: Detail type: string docs: description: A URL to documentation about this error code. title: Docs type: string x-remove-null-from-type-union: true params: description: An optional list of params that failed validation. items: $ref: '#/components/schemas/InvalidParam' title: Params type: array x-remove-null-from-type-union: true required: - detail - code title: Error type: object ReturnsFlag: enum: - inception_after_period_start - missing_history - twrr_uncomputable - mwrr_uncomputable - xirr_no_sign_change - xirr_single_cashflow properties: {} title: ReturnsFlag type: string InvalidParam: properties: code: description: A machine-readable error code. title: Code type: string detail: description: Human-readable detail for error. title: Detail type: string path: description: Path to the field name (or index if a list) that errored. items: anyOf: - type: integer - type: string title: Path type: array required: - path - detail - code title: InvalidParam type: object securitySchemes: HTTPBearer: scheme: bearer type: http ````