{"openapi":"3.1.0","info":{"title":"NewFBN — Agent Ordering API","version":"1.0.0","description":"Place California legal-notice publications (FBN/DBA, name change, summons, probate, trustee sale and more) in an adjudicated newspaper. The customer approves the exact text and pays at checkout from our email; agents cannot charge or publish on their own. MCP clients can use https://newfbn.com/mcp instead."},"servers":[{"url":"https://newfbn.com/api/agent"}],"paths":{"/notice-types":{"get":{"operationId":"list_notice_types","summary":"List the legal notices this newspaper publishes, with flat prices, number of weekly publications, and whether a court document is needed.","responses":{"200":{"description":"Notice types","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/fbn-lookup":{"get":{"operationId":"lookup_fbn_filing","summary":"Look up a California Fictitious Business Name (DBA) statement by its county file number and get the registered details to publish. Riverside numbers look like \"R-2026-001234\"; San Diego like \"2026-9012345\".","parameters":[{"name":"file_number","in":"query","required":true,"schema":{"type":"string"}},{"name":"county","in":"query","schema":{"type":"string","enum":["riverside","san-diego"]}}],"responses":{"200":{"description":"Filing","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/quote":{"post":{"operationId":"get_quote","summary":"Price, newspaper, copy deadline and the exact publication dates for a notice. For FBNs pass fbn_filing_date to check the 45-day publication window.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["notice_type"],"properties":{"notice_type":{"type":"string","description":"slug from list_notice_types"},"county":{"type":"string","enum":["riverside","san-diego"]},"fbn_filing_date":{"type":"string","description":"YYYY-MM-DD"},"fbn_additional_names":{"type":"array","items":{"type":"string"}},"nc_additional_names":{"type":"integer"},"we_file_for_you":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Quote","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/orders":{"post":{"operationId":"create_order","summary":"Place a publication order for a customer. We email the customer a secure link; they confirm their email, review the exact text and pay at checkout. Nothing is charged or published without the customer. Returns order_number, checkout_url and access_token.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["notice_type","customer_name","customer_email","customer_consent"],"properties":{"notice_type":{"type":"string","description":"slug from list_notice_types"},"county":{"type":"string","enum":["riverside","san-diego"]},"customer_name":{"type":"string"},"customer_email":{"type":"string","description":"the real customer's email — they receive the approval/payment link"},"customer_phone":{"type":"string"},"customer_consent":{"type":"boolean","description":"true = the customer asked you to place this order and agrees to receive our email"},"fbn_county_file_number":{"type":"string","description":"FBN only — preferred; we pull the statement from county records"},"fbn_filing_date":{"type":"string","description":"YYYY-MM-DD"},"fbn_business_name":{"type":"string"},"fbn_additional_names":{"type":"array","items":{"type":"string"}},"fbn_business_address":{"type":"string"},"fbn_business_city":{"type":"string"},"fbn_business_state":{"type":"string"},"fbn_business_zip":{"type":"string"},"fbn_business_type":{"type":"string","description":"e.g. Individual, Married Couple, Corporation, LLC"},"fbn_owner_name":{"type":"string"},"fbn_owner_address":{"type":"string"},"fbn_signer_name":{"type":"string"},"fbn_prior_county_file_number":{"type":"string","description":"renewal/abandonment: the earlier filing number"},"fbn_prior_filing_date":{"type":"string"},"notice_text":{"type":"string","description":"non-FBN notices: the exact text to publish"},"sd_notice_city":{"type":"string"},"nc_additional_names":{"type":"integer"},"we_file_for_you":{"type":"boolean"},"online_auction_listed":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Order placed; customer emailed","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/orders/{order_id}":{"get":{"operationId":"get_order_status","summary":"Check an order placed with create_order: whether the customer confirmed and paid, publication dates, and the checkout link.","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"access_token from create_order"}],"responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}}}