{"openapi":"3.1.0","info":{"title":"Fbenz Partner API","version":"1.0"},"paths":{"/api/v1/partner/stations":{"get":{"tags":["partner"],"summary":"Partner Stations","description":"Stations + current fuel status. Pass either `bbox=` or `city=` (+optional radius).","operationId":"partner_stations_api_v1_partner_stations_get","parameters":[{"name":"bbox","in":"query","required":false,"schema":{"type":"string","description":"lat1,lon1,lat2,lon2 (SW→NE)","default":"","title":"Bbox"},"description":"lat1,lon1,lat2,lon2 (SW→NE)"},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120,"default":"","title":"City"}},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","maximum":60.0,"exclusiveMinimum":0,"default":25.0,"title":"Radius Km"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/partner/stations/delta":{"get":{"tags":["partner"],"summary":"Partner Stations Delta","description":"Statuses changed since a timestamp — the cheap polling primitive.\n\nFeed `as_of` from each response into the next call. A window older than 48 h is\nrefused: statuses expire at 24 h, so a full `/stations` snapshot is the honest resync.","operationId":"partner_stations_delta_api_v1_partner_stations_delta_get","parameters":[{"name":"updated_since","in":"query","required":true,"schema":{"type":"string","description":"UTC, `YYYY-MM-DD HH:MM:SS` or ISO 8601","title":"Updated Since"},"description":"UTC, `YYYY-MM-DD HH:MM:SS` or ISO 8601"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/partner/stations/{station_id}":{"get":{"tags":["partner"],"summary":"Partner Station","operationId":"partner_station_api_v1_partner_stations__station_id__get","parameters":[{"name":"station_id","in":"path","required":true,"schema":{"type":"string","title":"Station Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Partner Station Api V1 Partner Stations  Station Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/partner/cities":{"get":{"tags":["partner"],"summary":"Partner Cities","operationId":"partner_cities_api_v1_partner_cities_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120,"default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Partner Cities Api V1 Partner Cities Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/partner/widget/config":{"get":{"tags":["partner"],"summary":"Widget Config","description":"Boot config for the white-label widget (publishable keys allowed).","operationId":"widget_config_api_v1_partner_widget_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Widget Config Api V1 Partner Widget Config Get"}}}}}}},"/api/v1/partner/limit-requests":{"post":{"tags":["partner"],"summary":"Limit Request Create","description":"File a limit-change request; it lands in our admin queue for review.\n\nOne pending request per partner — a second POST answers 409 until we decide.","operationId":"limit_request_create_api_v1_partner_limit_requests_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LimitRequestBody"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Limit Request Create Api V1 Partner Limit Requests Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["partner"],"summary":"Limit Requests List","description":"The partner's own limit-request history, newest first.","operationId":"limit_requests_list_api_v1_partner_limit_requests_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Limit Requests List Api V1 Partner Limit Requests Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/partner/usage":{"get":{"tags":["partner"],"summary":"Partner Usage","description":"The partner's own consumption: durable daily rows + today's hot counters.","operationId":"partner_usage_api_v1_partner_usage_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Partner Usage Api V1 Partner Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"BanBody":{"properties":{"fp":{"type":"string","title":"Fp","default":""},"tg_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tg Id"},"banned":{"type":"boolean","title":"Banned","default":true}},"type":"object","title":"BanBody"},"ChatBanBody":{"properties":{"nick":{"type":"string","title":"Nick","default":""},"wipe":{"type":"boolean","title":"Wipe","default":false}},"type":"object","title":"ChatBanBody"},"ChatBody":{"properties":{"station_id":{"type":"string","title":"Station Id","default":""},"fp":{"type":"string","title":"Fp","default":""},"text":{"type":"string","title":"Text","default":""},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"}},"type":"object","title":"ChatBody"},"ConsentBody":{"properties":{"choice":{"type":"string","pattern":"^(all|necessary)$","title":"Choice"},"policy_version":{"type":"string","maxLength":16,"title":"Policy Version","default":""},"visitor_id":{"type":"string","maxLength":64,"title":"Visitor Id","default":""}},"type":"object","required":["choice"],"title":"ConsentBody"},"DecisionBody":{"properties":{"approve":{"type":"boolean","title":"Approve"},"rpm_limit":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Rpm Limit"},"daily_quota":{"anyOf":[{"type":"integer","maximum":100000000.0,"minimum":1.0},{"type":"null"}],"title":"Daily Quota"},"comment":{"type":"string","maxLength":500,"title":"Comment","default":""}},"type":"object","required":["approve"],"title":"DecisionBody"},"DeleteStationBody":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"DeleteStationBody"},"FbReplyBody":{"properties":{"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"FbReplyBody"},"FbStatusBody":{"properties":{"status":{"type":"string","title":"Status","default":"read"}},"type":"object","title":"FbStatusBody"},"FeedbackBody":{"properties":{"text":{"type":"string","title":"Text","default":""},"contact":{"type":"string","title":"Contact","default":""},"visitor_id":{"type":"string","title":"Visitor Id","default":""},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"}},"type":"object","title":"FeedbackBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Health":{"properties":{"status":{"type":"string","title":"Status","default":"ok"}},"type":"object","title":"Health"},"HitBody":{"properties":{"visitor_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{0,64}$","title":"Visitor Id","default":""}},"type":"object","title":"HitBody"},"KeyCreateBody":{"properties":{"key_type":{"type":"string","pattern":"^(secret|publishable)$","title":"Key Type","default":"secret"}},"type":"object","title":"KeyCreateBody"},"LimitRequestBody":{"properties":{"requested_rpm":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Requested Rpm"},"requested_daily":{"type":"integer","maximum":100000000.0,"minimum":1.0,"title":"Requested Daily"},"comment":{"type":"string","maxLength":500,"title":"Comment","default":""}},"type":"object","required":["requested_rpm","requested_daily"],"title":"LimitRequestBody"},"LoginBody":{"properties":{"password":{"type":"string","title":"Password","default":""}},"type":"object","title":"LoginBody"},"MaintBody":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"message":{"type":"string","title":"Message","default":""}},"type":"object","title":"MaintBody"},"MineBody":{"properties":{"visitor_id":{"type":"string","title":"Visitor Id","default":""}},"type":"object","title":"MineBody"},"NotHereActionBody":{"properties":{"id":{"type":"string","title":"Id"},"action":{"type":"string","title":"Action","default":"dismiss"}},"type":"object","required":["id"],"title":"NotHereActionBody"},"NotHereBody":{"properties":{"osm_id":{"type":"string","title":"Osm Id"},"visitor_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{0,64}$","title":"Visitor Id","default":""}},"type":"object","required":["osm_id"],"title":"NotHereBody"},"NotifBody":{"properties":{"visitor_id":{"type":"string","title":"Visitor Id","default":""},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"}},"type":"object","title":"NotifBody"},"PartnerCreateBody":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"contact":{"type":"string","maxLength":200,"title":"Contact","default":""},"plan":{"type":"string","maxLength":24,"title":"Plan","default":"default"},"rpm_limit":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Rpm Limit","default":120},"daily_quota":{"type":"integer","maximum":100000000.0,"minimum":1.0,"title":"Daily Quota","default":50000},"allowed_domains":{"type":"string","title":"Allowed Domains","default":""},"allowed_ips":{"type":"string","title":"Allowed Ips","default":""},"tile_url":{"type":"string","title":"Tile Url","default":""},"notes":{"type":"string","title":"Notes","default":""},"with_publishable":{"type":"boolean","title":"With Publishable","default":false}},"type":"object","required":["name"],"title":"PartnerCreateBody"},"PartnerUpdateBody":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Name"},"contact":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Contact"},"plan":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}],"title":"Plan"},"rpm_limit":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Rpm Limit"},"daily_quota":{"anyOf":[{"type":"integer","maximum":100000000.0,"minimum":1.0},{"type":"null"}],"title":"Daily Quota"},"allowed_domains":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Allowed Domains"},"allowed_ips":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Allowed Ips"},"tile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tile Url"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"PartnerUpdateBody"},"QueueActionBody":{"properties":{"lat":{"type":"number","title":"Lat"},"lon":{"type":"number","title":"Lon"},"name":{"type":"string","title":"Name","default":""},"action":{"type":"string","title":"Action","default":"approve"}},"type":"object","required":["lat","lon"],"title":"QueueActionBody"},"ReportVoteBody":{"properties":{"report_id":{"type":"integer","title":"Report Id"},"fp":{"type":"string","pattern":"^[A-Za-z0-9_-]{5,64}$","title":"Fp"},"vote":{"type":"string","title":"Vote"},"trust_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trust Token"},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"}},"type":"object","required":["report_id","fp","vote"],"title":"ReportVoteBody"},"ResolveBody":{"properties":{"url":{"type":"string","title":"Url","default":""}},"type":"object","title":"ResolveBody"},"SuggestBody":{"properties":{"name":{"type":"string","title":"Name","default":""},"source_url":{"type":"string","title":"Source Url","default":""},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"source_type":{"type":"string","title":"Source Type","default":"map"},"visitor_id":{"type":"string","title":"Visitor Id","default":""},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"}},"type":"object","title":"SuggestBody"},"ThresholdBody":{"properties":{"add_auto":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Add Auto"},"add_review":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Add Review"},"nothere_threshold":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Nothere Threshold"}},"type":"object","title":"ThresholdBody"},"TrustBody":{"properties":{"fp":{"type":"string","pattern":"^[A-Za-z0-9_-]{5,64}$","title":"Fp"}},"type":"object","required":["fp"],"title":"TrustBody"},"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"},"VoteBody":{"properties":{"osm_id":{"type":"string","title":"Osm Id"},"status":{"type":"string","title":"Status"},"fp":{"type":"string","pattern":"^[A-Za-z0-9_-]{5,64}$","title":"Fp"},"report_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Id"},"client_ts":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Client Ts"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"text":{"type":"string","title":"Text","default":""},"fuels":{"items":{"type":"string"},"type":"array","title":"Fuels","default":[]},"fuels_no":{"items":{"type":"string"},"type":"array","title":"Fuels No","default":[]},"rep_lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rep Lat"},"rep_lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rep Lon"},"rep_acc_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rep Acc M"},"trust_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trust Token"},"cf":{"type":"string","title":"Cf","default":""},"express":{"type":"boolean","title":"Express","default":false},"queue":{"type":"string","title":"Queue","default":""},"prices":{"additionalProperties":{"type":"number"},"type":"object","title":"Prices","default":{}},"limit_l":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit L"},"no_cash":{"type":"boolean","title":"No Cash","default":false},"fuel_cards_only":{"type":"boolean","title":"Fuel Cards Only","default":false},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"}},"type":"object","required":["osm_id","status","fp"],"title":"VoteBody"}}},"security":[{"bearer":[]}]}