> ## Documentation Index > Fetch the complete documentation index at: https://docs.maple.inc/llms.txt > Use this file to discover all available pages before exploring further. # Get order > Returns a single order if it belongs to a location the app is connected to. ## OpenAPI ````yaml /openapi/developer-api.json get /orders/{orderId} openapi: 3.1.0 info: title: Maple Developer API version: 0.0.1 description: >- Public API for POS and platform partners to integrate with Maple: granted locations and connections, the order loop (validation, notification, accept/deny, status updates), payment-link visibility, menu publishing, and HMAC-signed webhooks. Authenticate every request with a Bearer API key (`mpk_test_…` / `mpk_live_…`). The credential determines the environment: test-mode credentials only see test data, live-mode credentials only see live data. servers: - url: https://api.maple.inc/v1 description: Production - url: https://api.staging.maple.inc/v1 description: Sandbox (development and testing) security: [] tags: - name: General description: Service status and credential introspection. - name: Locations description: The restaurant locations your app has been granted access to. - name: Connections description: Become (or stop being) a granted location’s order receiver. - name: Menu description: Publish and read a connected location’s menu. - name: Orders description: 'The order loop: read orders, submit validation results, and decide orders.' - name: Webhooks description: Event-type catalog, subscriptions, the event ledger, and replay. paths: /orders/{orderId}: get: tags: - Orders summary: Get order description: >- Returns a single order if it belongs to a location the app is connected to. operationId: developer-api.getOrder parameters: - name: orderId in: path schema: type: string required: true responses: '200': description: Success content: application/json: schema: type: object properties: object: type: string enum: - order id: type: string livemode: type: boolean description: >- True when the order belongs to the live environment; false for test-mode data. created: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN status: type: string payment_status: anyOf: - type: string - type: 'null' location_id: anyOf: - type: string - type: 'null' fulfillment_type: type: string customer: type: object properties: name: type: string phone_last_four: anyOf: - type: string - type: 'null' description: >- Last four digits of the customer phone number; the full number is never exposed. required: - name - phone_last_four additionalProperties: false line_items: type: array items: type: object properties: name: type: string menu_entity_id: anyOf: - type: string - type: 'null' quantity: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN base_price: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN tax: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN modifiers: type: array items: type: object properties: name: type: string menu_entity_id: anyOf: - type: string - type: 'null' quantity: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN price: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN required: - name - menu_entity_id - quantity - price additionalProperties: false description: >- A selected modifier. `price` is the price change in integer USD cents. required: - name - menu_entity_id - quantity - base_price - tax - modifiers additionalProperties: false description: >- An order line item. `base_price` (per unit, before modifiers) and `tax` are integer USD cents. `menu_entity_id` is the external id the partner published for the menu entity, when known. totals: type: object properties: currency: type: string subtotal: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN tax: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN surcharge: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN tip: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN delivery_fee: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN delivery_tip: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN total: anyOf: - anyOf: - type: number - type: string enum: - NaN - type: string enum: - Infinity - type: string enum: - '-Infinity' - type: string enum: - Infinity - '-Infinity' - NaN required: - currency - subtotal - tax - surcharge - tip - delivery_fee - delivery_tip - total additionalProperties: false description: >- All amounts in integer USD cents. `total` = subtotal + tax + surcharge + tip + delivery fees. external_id: anyOf: - type: string - type: 'null' payment: type: object properties: provider: anyOf: - type: string - type: 'null' status: anyOf: - type: string - type: 'null' payment_link_url: anyOf: - type: string - type: 'null' required: - provider - status - payment_link_url additionalProperties: false required: - object - id - livemode - created - status - payment_status - location_id - fulfillment_type - customer - line_items - totals - external_id - payment additionalProperties: false '401': description: DeveloperApiUnauthorized content: application/json: schema: $ref: '#/components/schemas/DeveloperApiUnauthorized' '403': description: DeveloperApiForbidden content: application/json: schema: $ref: '#/components/schemas/DeveloperApiForbidden' '404': description: DeveloperApiNotFound content: application/json: schema: $ref: '#/components/schemas/DeveloperApiNotFound' security: - bearer: [] components: schemas: DeveloperApiUnauthorized: type: object properties: _tag: type: string enum: - DeveloperApiUnauthorized message: type: string required: - _tag - message additionalProperties: false DeveloperApiForbidden: type: object properties: _tag: type: string enum: - DeveloperApiForbidden code: type: string enum: - insufficient_scope - wrong_environment message: type: string required: - _tag - code - message additionalProperties: false DeveloperApiNotFound: type: object properties: _tag: type: string enum: - DeveloperApiNotFound message: type: string required: - _tag - message additionalProperties: false securitySchemes: bearer: type: http scheme: bearer description: >- API key — `mpk_test_…` for the sandbox, `mpk_live_…` for production. Issued by Maple during partner onboarding. ````