> ## Documentation Index > Fetch the complete documentation index at: https://docs.decibel.trade/llms.txt > Use this file to discover all available pages before exploring further. # Get bulk order status > Retrieve the status of a specific bulk order (placed or rejected). Use `?asset_type=spot` to query the spot bulk-order tables; defaults to perp. The `market` parameter is one concrete market address, not a base-asset group. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/bulk_order_status openapi: 3.1.0 info: title: Decibel Trading API description: >- RESTful API for Decibel. Provides read-only endpoints for market data, trading operations, positions, and analytics. contact: name: Decibel Team url: https://decibel.trade/ license: name: '' version: 1.0.0 servers: - url: https://api.mainnet.aptoslabs.com/decibel description: Mainnet - url: https://api.testnet.aptoslabs.com/decibel description: Testnet security: - bearerAuth: [] tags: - name: Market Data description: Market information and real-time data endpoints - name: User description: User information and account management - name: Account description: Account-specific endpoints and data - name: Trades description: Trading operations and history - name: Positions description: User position management - name: Orders description: Order management and history - name: TWAP description: Time-weighted average price orders - name: Bulk Orders description: Bulk order management - name: Vaults description: Vault operations and management - name: Analytics description: Analytics and performance metrics - name: Points description: Points-related account metrics - name: Trading Points description: Trading points endpoints - name: Trading Hz description: Trading Hz endpoints - name: Tier description: Tier information endpoints - name: Streaks description: User streak tracking endpoints - name: Predeposit Rewards description: Season 0 predeposit USDC rewards - name: Referrals description: Referral code management and tracking - name: Affiliates description: Affiliate code and earnings endpoints - name: Campaigns description: On-chain reward campaign endpoints paths: /api/v1/bulk_order_status: get: tags: - Bulk Orders summary: Get bulk order status description: >- Retrieve the status of a specific bulk order (placed or rejected). Use `?asset_type=spot` to query the spot bulk-order tables; defaults to perp. The `market` parameter is one concrete market address, not a base-asset group. operationId: handle_bulk_order_status parameters: - name: account in: query description: User account address (`user` query alias is also accepted) required: true schema: type: string example: 0x123... - name: market in: query description: >- Concrete market address. Spot and perp markets with the same base asset have different addresses. required: true schema: type: string example: 0xmarket123... - name: sequence_number in: query description: Sequence number of the bulk order required: true schema: type: integer format: int64 minimum: 0 example: 12345 - name: asset_type in: query description: >- Asset type discriminator. Defaults to `"perp"` when omitted so the endpoint preserves prior behaviour for perp callers; pass `"spot"` to query the spot tables instead. (Bulk-order status is keyed by (account, market, sequence_number) — those keys are independent across products, so a single call cannot meaningfully UNION both.) required: false schema: $ref: '#/components/schemas/AssetType' example: perp responses: '200': description: Bulk order status retrieved successfully content: application/json: schema: $ref: '#/components/schemas/BulkOrderStatusResponse' components: schemas: AssetType: type: string description: >- Discriminator carried on DTOs that can mix perp and spot rows (markets, orders, trades, bulk orders, bulk order fills, and WebSocket payloads). Also accepted as a query parameter on REST endpoints that can filter to one product. Wire format is lowercase (`"perp"` / `"spot"`) and accepted case-insensitively on the request side via [`impl_case_insensitive_deserialize`]. enum: - perp - spot BulkOrderStatusResponse: type: object required: - status - details - bulk_order properties: bulk_order: $ref: '#/components/schemas/BulkOrderDto' details: type: string status: type: string BulkOrderDto: type: object required: - asset_type - market - user - sequence_number - bid_prices - bid_sizes - ask_prices - ask_sizes - cancelled_bid_prices - cancelled_bid_sizes - cancelled_ask_prices - cancelled_ask_sizes - cancellation_reason - transaction_version - transaction_unix_ms - event_uid properties: ask_prices: type: array items: type: number format: double example: - 101 - 102 - 103 ask_sizes: type: array items: type: number format: double example: - 1 - 2 - 3 asset_type: $ref: '#/components/schemas/AssetType' description: >- `"perp"` or `"spot"` — discriminator so callers can mix perp and spot rows in the same response without ambiguity. bid_prices: type: array items: type: number format: double example: - 99 - 98 - 97 bid_sizes: type: array items: type: number format: double example: - 1 - 2 - 3 cancellation_reason: type: string cancelled_ask_prices: type: array items: type: number format: double example: [] cancelled_ask_sizes: type: array items: type: number format: double example: [] cancelled_bid_prices: type: array items: type: number format: double example: - 100 cancelled_bid_sizes: type: array items: type: number format: double example: - 1 event_uid: $ref: '#/components/schemas/u128' market: type: string example: 0xmarket123... previous_seq_num: type: - integer - 'null' format: int64 example: 12344 minimum: 0 sequence_number: type: integer format: int64 example: 12345 minimum: 0 transaction_unix_ms: type: integer format: int64 example: 1730841600000 transaction_version: type: integer format: int64 example: 12345 minimum: 0 user: type: string example: 0x123... u128: type: integer minimum: 0 securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer token from Geomi. See [Authentication](/api-reference/rest/authentication) for setup instructions. ````