{"openapi":"3.1.0","info":{"title":"GET /api/v1/bills/payment-suggestions","version":"1.0.0","description":"List bill payment suggestions"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/bills/payment-suggestions":{"get":{"tags":["bills"],"summary":"List bill payment suggestions","description":"List auto-detected matches between bank transactions and open bills.","operationId":"list_bill_payment_suggestions_api_v1_bills_payment_suggestions_get","parameters":[{"name":"bill_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by bill UUID","title":"Bill Id"},"description":"Filter by bill UUID"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","default":"pending","title":"Status"},"description":"Filter by status"},{"name":"min_confidence","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum confidence threshold","title":"Min Confidence"},"description":"Minimum confidence threshold"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Only include suggestions whose transaction date is on or after this date (YYYY-MM-DD)","title":"Start Date"},"description":"Only include suggestions whose transaction date is on or after this date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Only include suggestions whose transaction date is on or before this date (YYYY-MM-DD)","title":"End Date"},"description":"Only include suggestions whose transaction date is on or before this date (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max results","default":100,"title":"Limit"},"description":"Max results"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillPaymentSuggestionsListResponse"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BillPaymentSuggestionResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Suggestion UUID"},"bill_id":{"type":"string","title":"Bill Id","description":"Bill UUID"},"bill_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Number","description":"Bill number"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name","description":"Vendor name"},"transaction_id":{"type":"string","title":"Transaction Id","description":"Transaction UUID"},"transaction_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Description","description":"Transaction description"},"transaction_counterparty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Counterparty","description":"Transaction counterparty"},"transaction_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Transaction Date","description":"Date of the transaction"},"transaction_account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Account Name","description":"Name of the ledger/bank account the transaction posted to"},"business_id":{"type":"string","title":"Business Id","description":"Business UUID"},"amount":{"type":"integer","title":"Amount","description":"Suggested payment amount in cents"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","description":"Match confidence (0–1)"},"signals":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Signals","description":"Signal score breakdown"},"match_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Group Id","description":"Group ID for multi-bill matches"},"status":{"type":"string","title":"Status","description":"pending | accepted | rejected | expired"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At","description":"When reviewed"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At","description":"When created"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"When updated"}},"type":"object","required":["id","bill_id","transaction_id","business_id","amount","confidence","status"],"title":"BillPaymentSuggestionResponse","description":"Response schema for a bill payment suggestion."},"BillPaymentSuggestionsListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BillPaymentSuggestionResponse"},"type":"array","title":"Items","description":"List of suggestions"},"pending_count":{"type":"integer","title":"Pending Count","description":"Total pending suggestions","default":0}},"type":"object","title":"BillPaymentSuggestionsListResponse","description":"Response schema for listing bill payment suggestions."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}