> ## 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 an account > Retrieve an account by ID or reference. ## OpenAPI ````yaml /openapi.json get /accounts/{id_or_reference} 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/{id_or_reference}: get: tags: - accounts summary: Retrieve an account description: Retrieve an account by ID or reference. operationId: get_account_accounts__id_or_reference__get parameters: - in: path name: id_or_reference required: true schema: title: Id Or Reference type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/Account' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request security: - HTTPBearer: [] components: schemas: Account: properties: bank_payment_reference: description: Reference used to identify bank payments for the account. title: Bank Payment Reference type: string base_currency: allOf: - $ref: '#/components/schemas/Currency' description: Currency used for account valuation. can_deposit: description: Whether deposits are currently allowed. title: Can Deposit type: boolean can_place_buy_order: description: Whether buy orders are currently allowed. title: Can Place Buy Order type: boolean can_place_sell_order: description: Whether sell orders are currently allowed. title: Can Place Sell Order type: boolean can_withdraw: description: Whether withdrawals are currently allowed. title: Can Withdraw type: boolean created_at: description: >- The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. format: date-time title: Created At type: string funding_currencies: description: Currencies accepted for account funding. items: $ref: '#/components/schemas/Currency' title: Funding Currencies type: array has_deposited: description: Whether the account has completed a deposit. title: Has Deposited type: boolean has_placed_buy_order: description: Whether the account has placed a buy order. title: Has Placed Buy Order type: boolean has_placed_sell_order: description: Whether the account has placed a sell order. title: Has Placed Sell Order type: boolean has_withdrawn: description: Whether the account has completed a withdrawal. title: Has Withdrawn type: boolean id: description: Unique resource identifier. title: Id type: string is_primary_owner_mifid_pro: description: Whether the primary owner is classified as a MiFID professional. title: Is Primary Owner Mifid Pro type: boolean modified_at: description: >- The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. format: date-time title: Modified At type: string name: description: Display name of the account. title: Name type: string reference: description: Customer-visible account reference. title: Reference type: string status: allOf: - $ref: '#/components/schemas/AccountStatus' description: Current account status. required: - created_at - modified_at - id - reference - status - name - bank_payment_reference - base_currency - funding_currencies - can_deposit - can_withdraw - can_place_buy_order - can_place_sell_order - has_deposited - has_withdrawn - has_placed_buy_order - has_placed_sell_order - is_primary_owner_mifid_pro title: Account 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 Currency: enum: - EUR - USD - GBP properties: {} title: Currency type: string AccountStatus: enum: - active - suspended - closing - closed properties: {} title: AccountStatus 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 ````