> ## Documentation Index > Fetch the complete documentation index at: https://docs.oms.verolabs.co/llms.txt > Use this file to discover all available pages before exploring further. # List accounts for the current user > List accounts for the current user ## OpenAPI ````yaml openapi.docs.en.json GET /api/v1/users/accounts openapi: 3.0.3 info: title: Vero OMS REST API version: 1.0.24 description: >- REST API documentation for Vero OMS. Paths are aligned with the active KrakenD gateway config under k8s-dev-gitops/vero-algo/tools/krakend and response schemas are expanded from backend/frontend source models. servers: - url: https://api-gw.verolabs.co description: API gateway security: [] tags: - name: Auth description: Authentication flows and app logout - name: Signup description: APIs used during account signup - name: Accounts description: User accounts, balances, positions, deposits and withdrawals - name: Bank Accounts description: Saved bank account management - name: Orders description: Order placement, cancellation, modification and order history - name: History description: Account orders, trades and cash transactions. - name: Market Data description: Watchlists, symbol search, product master and OHLCV history - name: Notifications description: In-app notifications - name: Referral description: Referral code, rebate and commission summary APIs - name: Diagnostics description: Health and diagnostic endpoints paths: /api/v1/users/accounts: get: tags: - Accounts summary: List accounts for the current user description: List accounts for current user. operationId: listAccounts responses: '200': description: Accounts returned by the account service. content: application/json: schema: type: array items: $ref: '#/components/schemas/Account' '400': $ref: '#/components/responses/ErrorResponse' description: Error response. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Plain-text backend or gateway error message. '401': $ref: '#/components/responses/ErrorResponse' description: Error response. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Plain-text backend or gateway error message. '404': $ref: '#/components/responses/ErrorResponse' description: Error response. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Plain-text backend or gateway error message. '500': $ref: '#/components/responses/ErrorResponse' description: Error response. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Plain-text backend or gateway error message. security: - bearerAuth: [] components: schemas: Account: type: object additionalProperties: true description: Trading account, equity, margin, PnL, and position summary. required: - id - accountId - totalEquity - credit - maintenanceMargin - tempMaintenanceMargin - totalRealizedPnl - totalUnrealizedPnl - tradingPower - crossMargin - positions - tempPositions properties: id: type: string description: Internal account document identifier. accountId: type: string description: Trading account identifier used by order and portfolio APIs. userId: type: string description: Owner user identity id or email propagated by the gateway. connectionType: type: string description: Account connection type such as DEMO or REAL. totalEquity: type: number description: Total account equity. credit: type: number description: Available credit or cash balance maintained by the account service. maintenanceMargin: type: number description: Current maintenance margin requirement. tempMaintenanceMargin: type: number description: Temporary maintenance margin for pending orders/positions. totalRealizedPnl: type: number description: Total realized profit and loss. totalUnrealizedPnl: type: number description: Total unrealized profit and loss. tradingPower: type: number description: Available trading power after margin and holds. crossMargin: type: boolean description: Whether cross-margin mode is enabled for this account. refCode: type: string description: Referral code linked to the account, if any. identityId: type: string description: Authentication identity id when present. positions: type: object additionalProperties: $ref: '#/components/schemas/Position' description: Open positions keyed by symbol. tempPositions: type: object additionalProperties: $ref: '#/components/schemas/TempPosition' description: Temporary or pending positions keyed by symbol. AnyErrorBody: oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' - $ref: '#/components/schemas/AuthFlow' description: >- Structured error body returned by gateway, ASP.NET services, or backend validation handlers. ValidationProblemDetails: allOf: - $ref: '#/components/schemas/ProblemDetails' - type: object additionalProperties: true properties: errors: type: object additionalProperties: oneOf: - type: array items: type: string - type: string description: Validation errors keyed by request field name. description: >- Validation problem response returned when request parameters or body fields are invalid. ProblemDetails: type: object additionalProperties: true description: RFC 7807-style problem response returned by ASP.NET/gateway services. properties: type: type: string description: Problem type URI. title: type: string description: Short problem title. status: type: integer description: HTTP status code. detail: type: string description: Detailed error message. traceId: type: string description: Trace id for backend diagnostics. Position: type: object additionalProperties: true description: Open portfolio position for one symbol. properties: id: type: string description: Position identifier. accountId: type: string description: Owning trading account. symbol: type: string description: Position symbol. avgPrice: type: number description: Average entry price. qty: type: number description: Net quantity. Positive is long, negative is short. marketPrice: type: number description: Latest market price used for valuation. marketValue: type: number description: Current market value. portPercent: type: number description: Portfolio weight percentage. realizePnl: type: number description: Realized PnL for the position. unrealizePnl: type: number description: Unrealized PnL for the position. coveredMarginCall: type: number description: Covered margin-call amount set by the user. marginRatio: $ref: '#/components/schemas/MarginRatio' forceClosePrice: type: number description: Estimated force-close price. forceCloseStatus: type: string description: Current force-close status. marginCallPrice: type: number description: Estimated margin-call price. marginCallStatus: type: string description: Current margin-call status. TempPosition: type: object additionalProperties: true description: Aggregated pending order position for one symbol. properties: symbol: type: string description: Symbol. netQty: type: number description: Net pending quantity. avgPrice: type: number description: Average pending price. orderCount: type: integer description: Number of pending orders contributing to this temp position. marketPrice: type: number description: Latest market price. ErrorResponse: type: object additionalProperties: true description: >- Error body returned by gateway or backend services. Backends can return either JSON objects or plain text errors. properties: error: oneOf: - type: string - type: object additionalProperties: true properties: id: type: string description: gateway error id when supplied. code: type: integer description: HTTP-like error code. status: type: string description: HTTP status text, for example Unauthorized. reason: type: string description: >- Detailed reason returned by the authentication service or gateway. message: type: string description: Human-readable error message. description: Error code/message string or nested gateway error object. message: type: string description: Human-readable error message. detail: type: string description: Detailed backend error message when available. details: oneOf: - type: string - type: object additionalProperties: true - type: array items: type: object additionalProperties: true description: Additional validation or backend details. nullable: true status: type: integer description: HTTP status code when included by the backend. AuthFlow: type: object additionalProperties: true properties: id: type: string description: >- Flow id. Use this value as the flow query parameter when submitting or updating the flow. type: type: string description: Flow type returned by the system, for example browser or api. expires_at: type: string format: date-time description: Timestamp when the flow expires. Submit the flow before this time. issued_at: type: string format: date-time description: Timestamp when created the flow. ui: type: object additionalProperties: true description: >- UI payload containing action URL, method, nodes, messages, and CSRF node when required. state: type: string description: >- Current flow state, such as choose_method, sent_email, passed_challenge, or success. request_url: type: string description: Original request URL used to create the flow. organization_id: type: string nullable: true description: organization id for organization-scoped flows, when supplied. created_at: type: string description: Flow creation timestamp. format: date-time updated_at: type: string description: Flow update timestamp. format: date-time refresh: type: boolean description: Whether the flow is a refresh flow. requested_aal: type: string description: Requested authenticator assurance level for the flow. identity: allOf: - 9cb587e8-c15a-435c-916a-4854d0ffa2c6 description: Identity attached to settings flows when the system includes it. description: >- self-service flow object returned by login, registration, recovery, and settings create/update endpoints. MarginRatio: type: object additionalProperties: true description: Margin, fee, tax, and risk-ratio configuration. properties: marginRatio: type: number description: Initial/maintenance margin ratio requirement. marginCallRate: type: number description: Margin-call threshold rate. forceCloseRate: type: number description: Force-close threshold rate. tradingFee: type: number description: Trading fee rate, for example 0.001 for 0.1%. productCommission: type: number description: Product commission rate. tax: type: number description: Tax rate. overnightFee: type: number description: Overnight fee rate. shortSellFee: type: number description: Short-sell fee rate. responses: ErrorResponse: description: Error response containing an error code, message, detail, or plain text. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' text/plain: schema: type: string securitySchemes: bearerAuth: type: http scheme: bearer description: Bearer token used for protected REST API requests. ````