List Repair Costs
GET/api/repairs/:repair/costs
Lists every cost line on a repair (parts, labour, vendor services, freight, fees), with the repair's cost totals and any repair accounting roles that still need a nominal code.
repairs:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Query parameters (all optional):
repair_order_line_id(integer) — only the costs on that unit.type(string) — one ofpart,labour,vendor_service,freight_inbound,freight_outbound,assessment_fee,other.
Response data:
costs— the cost lines. Each cost line returns:id,repair_order_id,repair_order_line_id,line_number,type/type_label,description,product_id+product{id, sku, name},warehouse_id+warehouse{id, name},quantity(in the part's stock unit),entered_quantity+entered_uom_id+entered_uom{id, code, name} (what was typed when another unit was used),operation/operation_label(add,remove,recycle; parts only),state/state_label(planned,consumed),is_posted(true for consumed lines, which carry a journal),unit_cost,total_cost,bill_price,bill_total(bill_price × quantity),bill_to/bill_to_label,inventory_movement_id,ledger_journal_entry_id,journal_entry{id, reference, document_number, status, effective_at, total, display_status {key, label, color}, route},repair_shipment_id,purchase_order_id,recovery_claim_id,created_by,created_at,updated_at.totals— see Get Repair Cost Totals.unmapped_nominal_code_roles— repair accounting roles with no nominal code mapped yet (warranty_expense,warranty_reserve,goodwill_repair_expense,repair_revenue,repair_cost_of_sales). Posted costs fall back to the cost-of-goods account until they are mapped.
Authentication: Bearer token with the repairs:read scope.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.