Submit Repair Claim
POST/api/repairs/claims
Submit Repair Claim.
repairs:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Request fields:
source(required): string, In:in:"loop","aftership","corso","claimlane","returngo","api"external_id(required): string, max:120order_reference(optional): string, max:120channel(optional): string, max:40customer_id(optional): integer, exists:customers,idcustomer(optional): arraycustomer.email(optional): email:rfc, max:190customer.name(optional): string, max:190customer.phone(optional): string, max:40warehouse_id(optional): integer, exists:warehouses,idlocation(optional): string, max:190inbound_method(optional): Enum:in:"customer_ships","drop_off","already_received","no_return_needed"purchase(optional): arraypurchase.date(optional): date_format:Y-m-d, before_or_equal:todaypurchase.source(optional): Enum:in:"order","shopify","amazon","retail_store","wholesale_partner","gift","other"purchase.retailer_name(optional): string, max:190notes(optional): string, max:5000notify_customer(optional): booleanlines(required): array, min:1, max:100lines.*.external_line_id(optional): string, max:120lines.*.product_id(optional): integerlines.*.sku(optional): string, max:190lines.*.barcode(optional): string, max:190lines.*.channel_product_id(optional): string, max:190lines.*.quantity(optional): integer, min:1, max:10000lines.*.serial_number(optional): string, max:190lines.*.lot_number(optional): string, max:100lines.*.reason(optional): string, max:255lines.*.issue_type_ids(optional): arraylines.*.issue_type_ids.*(optional): integer, exists:repair_issue_types,idlines.*.description(optional): string, max:5000lines.*.product_text(optional): string, max:255lines.*.requested_service(optional): Enum:in:"repair","replate","replace"attachment_urls(optional): array, max:10attachment_urls.*(optional): string, max:2048, url, starts_with:https://
Permission: repairs.create.
Authentication: Bearer token with the repairs:read / write scope.
Request
Responses
- 200
- 401
- 403
- 422
- 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.
Unprocessable Content
Response Headers
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.