# Get order by ID ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/account/orders/{orderId}: get: summary: Get order by ID deprecated: false description: Returns a single order by its identifier. operationId: getOrder tags: - API/Trading/Orders - Orders parameters: - name: orderId in: path description: The order ID to retrieve. required: true example: 1219733c-4214-4ce8-9369-22aa132cab0b schema: type: string format: uuid responses: '200': description: Success content: application/json: schema: type: object properties: id: type: string description: Unique order identifier (UUID) examples: - a3bb189e-8bf9-3888-9912-ace4e6543002 pair: type: string description: Trading pair identifier examples: - BTC-EUR side: type: string description: Order side enum: - Buy - Sell examples: - Buy type: type: string description: Order type enum: - Limit - Market - StopLimit - StopMarket examples: - Limit status: type: string description: Current order status enum: - new - filled - filled-and-canceled - partially-filled - canceled - done-for-day - rejected examples: - new pricedIn: type: string description: Currency used to express the order quantity examples: - BTC quantity: type: string description: >- Order quantity in base currency; null if price is unavailable examples: - '0.5' nullable: true amount: type: string description: >- Order amount in quote currency; null if price is unavailable examples: - '15000.0' nullable: true limitPrice: type: string description: Limit price; only present for Limit and StopLimit orders examples: - '30000.0' nullable: true triggerPrice: type: string description: >- Trigger price; only present for StopLimit and StopMarket orders examples: - '29500.0' nullable: true filledQuantity: type: string description: >- Filled quantity in base currency; null until at least one fill occurs examples: - '0.25' nullable: true filledAmount: type: string description: >- Filled amount in quote currency; null until at least one fill occurs examples: - '7500.0' nullable: true filledPercentage: type: string description: Percentage of the order that has been filled (0–100) examples: - '50.0' filledAveragePrice: type: string description: Average fill price; null until at least one fill occurs examples: - '30000.0' nullable: true fee: type: object properties: amount: type: string description: Fee amount as a decimal string examples: - '0.45' currency: type: string description: Fee currency code examples: - EUR description: >- Fee charged on the order; null until the order generates a fee x-apidog-orders: - amount - currency nullable: true timeInForce: type: string description: Time-in-force policy enum: - GTC - GTD - IOC - FOK examples: - GTC updatedAt: type: string description: ISO 8601 timestamp of the last update (UTC) examples: - '2024-06-15T10:30:00.000Z' createdAt: type: string description: ISO 8601 timestamp when the order was submitted (UTC) examples: - '2024-06-15T10:29:55.000Z' executedAt: type: string description: >- ISO 8601 timestamp when the order was executed; null for open/pending orders examples: - '2024-06-15T10:30:01.000Z' nullable: true endTime: type: string description: >- Expiry time for GTD orders; null for all other time-in-force types examples: - '2024-06-16T00:00:00.000Z' nullable: true x-apidog-orders: - id - pair - side - type - status - pricedIn - quantity - amount - limitPrice - triggerPrice - filledQuantity - filledAmount - filledPercentage - filledAveragePrice - fee - timeInForce - updatedAt - createdAt - executedAt - endTime headers: {} x-apidog-name: '' '400': description: Invalid path variable or missing required header content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors headers: {} x-apidog-name: '' '403': description: Order does not belong to the requesting user content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors example: errors: - code: ORDER_DOES_NOT_BELONG_TO_USER status: 403 field: null title: Order does not belong to user headers: {} x-apidog-name: '' '404': description: Order not found content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors example: errors: - code: ORDER_NOT_FOUND status: 404 field: null title: Order not found headers: {} x-apidog-name: '' '500': description: Unexpected server error content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors example: errors: - code: 500 INTERNAL_SERVER_ERROR status: 500 field: null title: An unexpected error occurred headers: {} x-apidog-name: '' security: - ApiKeyAuth: [] x-apidog: schemeGroups: - id: R9ATmeDbnmf3oaxVszr_g schemeIds: - ApiKeyAuth required: true use: id: R9ATmeDbnmf3oaxVszr_g scopes: R9ATmeDbnmf3oaxVszr_g: ApiKeyAuth: [] x-apidog-folder: API/Trading/Orders x-apidog-status: released x-run-in-apidog: https://app.eu.apidog.com/web/project/363759/apis/api-4203922-run components: schemas: {} securitySchemes: ApiKeyAuth: type: apikey description: API key for authentication. Issued by Bitpanda. name: x-api-key in: header servers: - url: https://api.fusion.bitpanda.com description: Production security: [] ```