--- updatedAt: 2026-09-18T05:08:48.000Z agentTools: projectIndex: https://docs.newmoneycompany.com/llms.txt --- # Retrieve single order for given company This endpoint returns the same object as in the multiple orders endpoint but will also fill in PDF URLs for any documents in the order # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "New Money Company API", "version": "1.0" }, "servers": [ { "url": "https://api.newmoneycompany.com/", "description": "Production API server" } ], "paths": { "/v1/companies/{company_id}/orders/{order_id}": { "get": { "tags": [ "Orders" ], "summary": "Retrieve single order for given company", "description": "This endpoint returns the same object as in the multiple orders endpoint but will also fill in PDF URLs for any documents in the order", "operationId": "get_v1_companies_id_orders_id", "parameters": [ { "name": "company_id", "in": "path", "description": "Company ID (c_xxxxxxxx)", "required": true, "schema": { "type": "string" } }, { "name": "order_id", "in": "path", "description": "Order ID (o_xxxxxxxx)", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Orders", "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Order" } }, "type": "object" } } } }, "400": { "description": "Invalid company ID" } } } } }, "components": { "schemas": { "FreightPaymentTerms": { "type": "string", "enum": [ "PREPAYMENT", "FREIGHT_COLLECT", "MANAGED_BY_BUYER", "MANAGED_BY_SUPPLIER" ] }, "Incoterm": { "type": "string", "enum": [ "EXW", "FCA", "CPT", "CIP", "DAP", "DPU", "DDP", "FAS", "FOB", "CFR", "CIF" ] }, "LogisticsMode": { "type": "string", "enum": [ "PLATFORM", "BUYER", "SUPPLIER" ] }, "OrderStatus": { "type": "string", "enum": [ "OPEN", "COMPLETE", "CANCELLED", "SHIPPED", "DELIVERED", "PAID" ] }, "Order": { "required": [ "company_id", "supplier_company_id", "buyer_company_id" ], "properties": { "company_id": { "type": "string" }, "supplier_company_id": { "description": "ID of the supplier company. Company must be of BUSINESS type and different from buyer company", "type": "string" }, "buyer_company_id": { "description": "ID of the buyer company. Company must be of BUSINESS type and different from supplier company", "type": "string" }, "status": { "$ref": "#/components/schemas/OrderStatus" }, "name": { "description": "Name of this order", "type": [ "string", "null" ] }, "order_number": { "description": "Human-readable order number. Can be customized or it will be generated based on previous order.", "type": [ "string", "null" ] }, "notes": { "description": "Notes to put on order. Will show up on purchase orders and invoices", "type": [ "string", "null" ] }, "is_tci_protected": { "description": "Whether or not this order will have payment guaranteed by TCI policy. If flag is set then extra documentation will be generated to comply with policy", "type": "boolean" }, "pickup_address_id": { "description": "ID of address where order will be picked up. Address should be owned by the supplier company", "type": [ "string", "null" ] }, "delivery_address_id": { "description": "ID of address where order will be delivered. Address should be owned by the buyer company", "type": [ "string", "null" ] }, "shipment_incoterms": { "oneOf": [ { "$ref": "#/components/schemas/Incoterm" }, { "type": "null" } ] }, "shipment_method": { "type": [ "string", "null" ] }, "shipment_freight_payment_terms": { "oneOf": [ { "$ref": "#/components/schemas/FreightPaymentTerms" }, { "type": "null" } ] }, "cargo_ready_date": { "type": [ "string", "null" ], "format": "date" }, "goods_transfer_date": { "type": [ "string", "null" ], "format": "date" }, "must_arrive_by_date": { "type": [ "string", "null" ], "format": "date" }, "marketplace_transaction_date": { "type": [ "string", "null" ], "format": "date" }, "buyer_payment_due_days": { "type": [ "integer", "null" ] }, "supplier_payment_due_days": { "type": [ "integer", "null" ] }, "take_rate_basis_points": { "description": "Set to the amount that you are taking as commission on this order. Integer basis point value means 100 = 1% commission", "type": [ "integer", "null" ] }, "id": { "type": [ "string", "null" ], "readOnly": true }, "is_prepaid": { "description": "If order is prepaid then we generate invoice earlier in process and require payment before marking shipped. Cannot do prepaid with TCI", "type": "boolean" }, "supplier_cash_balance_id": { "type": [ "string", "null" ] }, "commission_cash_balance_id": { "type": [ "string", "null" ] }, "logistics_mode": { "$ref": "#/components/schemas/LogisticsMode" }, "items": { "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/OrderItem", "description": "Array of all items on the order. Can be specified all at once on the create or use items endpoints to update an existing order. This field is only populated on output when querying a single order and not on the multiple order endpoint" }, { "type": "null" } ], "description": "Array of all items on the order. Can be specified all at once on the create or use items endpoints to update an existing order. This field is only populated on output when querying a single order and not on the multiple order endpoint" } }, "total_amount": { "type": [ "integer", "null" ], "readOnly": true }, "original_po_amount": { "type": [ "integer", "null" ], "readOnly": true }, "reference_id": { "description": "Internal reference ID for an order. Can be used to map back to your own system", "type": [ "string", "null" ], "maxLength": 64 }, "supplier_reference": { "description": "Reference identifier provided by the supplier for this order", "type": [ "string", "null" ], "maxLength": 64 }, "buyer_reference": { "description": "Reference identifier provided by the buyer for this order", "type": [ "string", "null" ], "maxLength": 64 }, "supplier_notes": { "description": "Additional note shown only on supplier and NMC purchase orders", "type": [ "string", "null" ] } }, "type": "object" }, "OrderItem": { "properties": { "description": { "type": "string" }, "quantity": { "type": "integer" }, "unit_cost": { "type": "integer" }, "takes_commission": { "description": "Set flag to indicate if take rate should be applied to this item in the order", "type": "boolean" }, "reference_id": { "description": "Internal reference ID for an order. Can be used to map back to your own system. Must be unique across all items on a single order and must be set for all items or none", "type": [ "string", "null" ], "maxLength": 64 } }, "type": "object" } }, "securitySchemes": { "api_key": { "type": "http", "description": "Use the company id (c_xxxxx) as the username and the API key as the password", "scheme": "basic" } } }, "security": [ { "api_key": [] } ], "tags": [ { "name": "Orders", "description": "Orders" } ], "x-readme": { "explorer-enabled": false, "proxy-enabled": false } } ```