List Match Run Proposals
GET/api/qbo/customers/match-runs/:matchRun/proposals
List the scored match proposals produced by a customer match run, ordered by score (highest first) and paginated (standard pagination metadata is included in the response). Each proposal pairs one QuickBooks Online customer with one SKU.io customer and includes the overall score (0-100), the confidence bucket, and a per-field breakdown of the signals (email, company, name, address, phone) that produced the score.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Buckets: auto (score at or above the auto threshold), review (between the review and auto thresholds), hidden (below the review threshold).
Proposal statuses: pending, approved, rejected, committed, superseded. rejection_reason is set when a proposal was auto-rejected because one side was already linked (qbo_customer_already_linked or sku_customer_already_linked).
Returns 404 if the run does not exist.
Authentication: Requires Bearer token.
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
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.