{"openapi":"3.1.0","info":{"title":"Concursuri Pescuit API","version":"1.0.0","summary":"Read-only API for fishing competitions.","description":"Public, versioned (v1) REST API for competitions, participants, sectors, standings, photos and locations.\n\n* Only public data is exposed. Drafts, private competitions and contact details are never returned.\n* No key is needed for basic access (low rate limit). Send `Authorization: Bearer <key>` (or `X-API-Key`) for higher limits and larger pages.\n* Weights are integer grams (`weight_g`) plus an exact decimal string in the competition's unit (`weight`). Money amounts are decimal strings.\n* Times are ISO 8601; each competition carries its own time zone.","license":{"name":"Proprietary"}},"servers":[{"url":"https://api.concursuripescuit.ro/v1","description":"Current environment"}],"tags":[{"name":"Competitions"},{"name":"Organizers"},{"name":"Locations"}],"paths":{"/competitions":{"get":{"operationId":"listCompetitions","summary":"List competitions","description":"Public competitions (drafts and private competitions never appear). Filter by place, organizer, fishing style, status and start date.","tags":["Competitions"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"description":"Page number (1-based).","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Items per page. Maximum 25 without an API key, 100 with one.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"q","in":"query","required":false,"description":"Case-insensitive search in the competition title.","schema":{"type":"string","minLength":1,"maxLength":100},"example":"cupa"},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 country code of the location.","schema":{"type":"string","pattern":"^[A-Za-z]{2}$"},"example":"RO"},{"name":"region","in":"query","required":false,"description":"Region / county of the location (exact match).","schema":{"type":"string","minLength":1,"maxLength":100},"example":"Ilfov"},{"name":"city","in":"query","required":false,"description":"City of the location (exact match).","schema":{"type":"string","minLength":1,"maxLength":100},"example":"Snagov"},{"name":"organizer","in":"query","required":false,"description":"Organizer id.","schema":{"type":"integer","minimum":1}},{"name":"location","in":"query","required":false,"description":"Location id.","schema":{"type":"integer","minimum":1}},{"name":"style","in":"query","required":false,"description":"Fishing style code (see the reference list in the developer guide), e.g. `feeder`.","schema":{"type":"string","minLength":1,"maxLength":40},"example":"feeder"},{"name":"status","in":"query","required":false,"description":"One or more statuses, comma separated.","schema":{"type":"array","items":{"type":"string","enum":["published","in_progress","awaiting_validation","finalized","cancelled"]}},"style":"form","explode":false,"example":"published,in_progress"},{"name":"starts_from","in":"query","required":false,"description":"Only competitions starting on or after this date (YYYY-MM-DD, UTC).","schema":{"type":"string","format":"date"},"example":"2027-01-01"},{"name":"starts_to","in":"query","required":false,"description":"Only competitions starting on or before this date (YYYY-MM-DD, UTC).","schema":{"type":"string","format":"date"},"example":"2027-12-31"},{"name":"sort","in":"query","required":false,"description":"Sort order; a leading minus means descending.","schema":{"type":"string","enum":["starts_at","-starts_at"],"default":"starts_at"}},{"name":"lang","in":"query","required":false,"description":"Language for translated texts. Falls back to Romanian, then to any available translation.","schema":{"type":"string","enum":["ro","en"],"default":"ro"}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCompetition"}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/competitions/{id}":{"get":{"operationId":"getCompetition","summary":"Get a competition","description":"Full public details of one competition, including rules, prizes, schedule and public contacts.","tags":["Competitions"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Numeric id.","schema":{"type":"integer","minimum":1}},{"name":"lang","in":"query","required":false,"description":"Language for translated texts. Falls back to Romanian, then to any available translation.","schema":{"type":"string","enum":["ro","en"],"default":"ro"}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CompetitionDetail"}}}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/competitions/{id}/participants":{"get":{"operationId":"listParticipants","summary":"List participants","description":"Confirmed participants only. Contact details are never exposed.","tags":["Competitions"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Numeric id.","schema":{"type":"integer","minimum":1}},{"name":"page","in":"query","required":false,"description":"Page number (1-based).","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Items per page. Maximum 25 without an API key, 100 with one.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"lang","in":"query","required":false,"description":"Reserved; participant data is not translated.","schema":{"type":"string","enum":["ro","en"],"default":"ro"}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListParticipant"}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/competitions/{id}/sectors":{"get":{"operationId":"listSectors","summary":"List sectors and stands","description":"Sectors with their stands and the people assigned to them.","tags":["Competitions"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Numeric id.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Sector"}}}}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/competitions/{id}/standings":{"get":{"operationId":"getStandings","summary":"Get standings","description":"Standings following the publication rules: `live` while running (if LIVE publication is enabled), `provisional` until the organizer validates, `final` afterwards, `hidden` otherwise.","tags":["Competitions"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Numeric id.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Standings"}}}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/competitions/{id}/photos":{"get":{"operationId":"listPhotos","summary":"List photos","description":"Photos that the organizer made visible.","tags":["Competitions"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Numeric id.","schema":{"type":"integer","minimum":1}},{"name":"page","in":"query","required":false,"description":"Page number (1-based).","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Items per page. Maximum 25 without an API key, 100 with one.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListPhoto"}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/organizers/{id}/competitions":{"get":{"operationId":"listOrganizerCompetitions","summary":"List an organizer's competitions","description":"Same representation as the global list, restricted to one organizer.","tags":["Organizers"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Numeric id.","schema":{"type":"integer","minimum":1}},{"name":"page","in":"query","required":false,"description":"Page number (1-based).","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Items per page. Maximum 25 without an API key, 100 with one.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"status","in":"query","required":false,"description":"One or more statuses, comma separated.","schema":{"type":"array","items":{"type":"string","enum":["published","in_progress","awaiting_validation","finalized","cancelled"]}},"style":"form","explode":false},{"name":"sort","in":"query","required":false,"description":"Sort order; a leading minus means descending.","schema":{"type":"string","enum":["starts_at","-starts_at"],"default":"starts_at"}},{"name":"lang","in":"query","required":false,"description":"Language for translated texts. Falls back to Romanian, then to any available translation.","schema":{"type":"string","enum":["ro","en"],"default":"ro"}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCompetition"}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/locations":{"get":{"operationId":"listLocations","summary":"List locations","description":"Fishing locations with the number of public competitions held there.","tags":["Locations"],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"description":"Page number (1-based).","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Items per page. Maximum 25 without an API key, 100 with one.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"q","in":"query","required":false,"description":"Case-insensitive search in the location name.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 country code.","schema":{"type":"string","pattern":"^[A-Za-z]{2}$"},"example":"RO"},{"name":"region","in":"query","required":false,"description":"Region / county (exact match).","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"city","in":"query","required":false,"description":"City (exact match).","schema":{"type":"string","minLength":1,"maxLength":100}}],"responses":{"200":{"description":"Success.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time when the window resets.","schema":{"type":"integer"}},"ETag":{"description":"Validator for conditional requests.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListLocation"}}}},"304":{"description":"Not modified (send `If-None-Match` with the previous `ETag`)."},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"webhooks":{"competition.created":{"post":{"summary":"Event competition.created","description":"Sent to your endpoint when `competition.created` happens. Verify the `X-Cupa-Signature` header (HMAC-SHA256 over `{timestamp}.{raw body}` with your subscription secret) and answer with any 2xx status within 8 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged. Any 2xx counts as delivered; anything else is retried with backoff."}}}},"competition.updated":{"post":{"summary":"Event competition.updated","description":"Sent to your endpoint when `competition.updated` happens. Verify the `X-Cupa-Signature` header (HMAC-SHA256 over `{timestamp}.{raw body}` with your subscription secret) and answer with any 2xx status within 8 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged. Any 2xx counts as delivered; anything else is retried with backoff."}}}},"competition.cancelled":{"post":{"summary":"Event competition.cancelled","description":"Sent to your endpoint when `competition.cancelled` happens. Verify the `X-Cupa-Signature` header (HMAC-SHA256 over `{timestamp}.{raw body}` with your subscription secret) and answer with any 2xx status within 8 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged. Any 2xx counts as delivered; anything else is retried with backoff."}}}},"competition.started":{"post":{"summary":"Event competition.started","description":"Sent to your endpoint when `competition.started` happens. Verify the `X-Cupa-Signature` header (HMAC-SHA256 over `{timestamp}.{raw body}` with your subscription secret) and answer with any 2xx status within 8 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged. Any 2xx counts as delivered; anything else is retried with backoff."}}}},"competition.finalized":{"post":{"summary":"Event competition.finalized","description":"Sent to your endpoint when `competition.finalized` happens. Verify the `X-Cupa-Signature` header (HMAC-SHA256 over `{timestamp}.{raw body}` with your subscription secret) and answer with any 2xx status within 8 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged. Any 2xx counts as delivered; anything else is retried with backoff."}}}},"standings.updated":{"post":{"summary":"Event standings.updated","description":"Sent to your endpoint when `standings.updated` happens. Verify the `X-Cupa-Signature` header (HMAC-SHA256 over `{timestamp}.{raw body}` with your subscription secret) and answer with any 2xx status within 8 seconds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged. Any 2xx counts as delivered; anything else is retried with backoff."}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key created in the organizer area, sent as `Authorization: Bearer cp_...`."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}},"responses":{"Unauthorized":{"description":"An API key was sent but is invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Resource not found (or not public).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ValidationFailed":{"description":"Invalid or unknown query parameters; see `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limit exceeded; see `Retry-After`.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the next window."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Competition":{"type":"object","required":["id","slug","title","description","status","results_status","is_team","live_results","weight_unit","timezone","starts_at","ends_at","starts_at_utc","ends_at_utc","registration","location","organizer","fishing_style","url","embed_url","ranking","charity","updated_at"],"properties":{"id":{"type":"integer"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"status":{"type":"string","enum":["published","in_progress","awaiting_validation","finalized","cancelled"]},"results_status":{"type":"string","enum":["none","provisional","final"]},"is_team":{"type":"boolean"},"live_results":{"type":"boolean"},"weight_unit":{"type":"string","enum":["g","kg"]},"timezone":{"type":"string"},"starts_at":{"type":["string","null"],"format":"date-time"},"ends_at":{"type":["string","null"],"format":"date-time"},"starts_at_utc":{"type":["string","null"],"format":"date-time"},"ends_at_utc":{"type":["string","null"],"format":"date-time"},"registration":{"type":"object","required":["open","mode","deadline","fee","max_participants","confirmed_participants"],"properties":{"open":{"type":"boolean"},"mode":{"type":"string","enum":["auto","approval"]},"deadline":{"type":["string","null"],"format":"date-time"},"fee":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"currency":{"type":"string","minLength":3,"maxLength":3}}},"max_participants":{"type":["integer","null"]},"confirmed_participants":{"type":"integer"}}},"location":{"oneOf":[{"type":"null"},{"type":"object","required":["id","name","slug","country","region","city","latitude","longitude"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"country":{"type":["string","null"]},"region":{"type":["string","null"]},"city":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}}]},"organizer":{"type":"object","required":["id","name","slug"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}}},"fishing_style":{"oneOf":[{"type":"null"},{"type":"object","required":["code","name"],"properties":{"code":{"type":"string"},"name":{"type":["string","null"]}}}]},"url":{"type":"string","format":"uri"},"embed_url":{"type":"string","format":"uri"},"ranking":{"type":"string","enum":["total_weight","points_sector"],"description":"`total_weight`: heaviest total wins. `points_sector`: 1 point for the heaviest catch in each sector, 2 for the next and so on; fewest points wins, ties broken by total weight."},"charity":{"oneOf":[{"type":"null"},{"type":"object","required":["beneficiary","cause","url","goal","raised","currency","fee_percent","raised_updated_at"],"properties":{"beneficiary":{"type":["string","null"]},"cause":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"goal":{"type":["string","null"],"pattern":"^\\d+\\.\\d{2}$"},"raised":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"currency":{"type":"string"},"fee_percent":{"type":"integer","minimum":0,"maximum":100,"description":"Share of the entry fees donated to the beneficiary."},"raised_updated_at":{"type":["string","null"],"format":"date-time"}}}],"description":"Present (non-null) only for charity competitions. Amounts are declared by the organizer."},"updated_at":{"type":["string","null"],"format":"date-time"}}},"CompetitionDetail":{"allOf":[{"$ref":"#/components/schemas/Competition"},{"type":"object","required":["rules","prizes","schedule","conditions","standard_rules","contacts"],"properties":{"rules":{"type":["string","null"]},"prizes":{"type":["string","null"]},"schedule":{"type":["string","null"]},"conditions":{"type":["string","null"]},"standard_rules":{"type":"object","description":"Rules common to every competition, as typed values. An absent key means \"not specified by the organizer\"; anything else is in the free-text `rules`.","properties":{"duration_h":{"type":"integer","minimum":1,"maximum":72,"description":"Unit: h","x-group":"format"},"rounds":{"type":"integer","minimum":1,"maximum":10,"x-group":"format"},"draw":{"type":"boolean","x-group":"format"},"ranking":{"type":"string","enum":["points_sector","total_weight"],"x-group":"format"},"tiebreak":{"type":"string","enum":["total_weight","biggest_fish","none"],"x-group":"format"},"max_rods":{"type":"integer","minimum":1,"maximum":6,"x-group":"gear"},"rod_max_m":{"type":"number","minimum":1,"maximum":15,"description":"Unit: m","x-group":"gear"},"single_hook":{"type":"boolean","x-group":"gear"},"spare_rods":{"type":"string","enum":["unlimited","limited","none"],"x-group":"gear"},"alarms":{"type":"string","enum":["allowed","carp_only","forbidden"],"x-group":"gear"},"live_bait":{"type":"string","enum":["forbidden","allowed"],"x-group":"gear"},"scored":{"type":"array","items":{"type":"string"},"x-group":"fish"},"release_others":{"type":"boolean","x-group":"fish"},"keepnet_min_m":{"type":"number","minimum":0.5,"maximum":10,"description":"Unit: m","x-group":"fish"},"sacks_min":{"type":"integer","minimum":0,"maximum":20,"x-group":"fish"},"mat_required":{"type":"boolean","x-group":"fish"},"heavy_fish_kg":{"type":"number","minimum":1,"maximum":100,"description":"Unit: kg","x-group":"fish"},"interim_kg":{"type":"number","minimum":1,"maximum":200,"description":"Unit: kg","x-group":"fish"},"weigh_when":{"type":"string","enum":["end","hourly","on_request"],"x-group":"fish"},"stay_in_peg":{"type":"boolean","x-group":"peg"},"peg_penalty":{"type":"integer","minimum":0,"maximum":20,"description":"Unit: p","x-group":"peg"},"companions_max":{"type":"integer","minimum":0,"maximum":5,"x-group":"peg"},"companion_fishes":{"type":"boolean","x-group":"peg"},"drill_min":{"type":"integer","minimum":0,"maximum":60,"description":"Unit: min","x-group":"peg"},"signals":{"type":"boolean","x-group":"peg"},"no_outside_help":{"type":"boolean","x-group":"peg"},"speed_kmh":{"type":"integer","minimum":1,"maximum":100,"description":"Unit: km/h","x-group":"conduct"},"alcohol":{"type":"string","enum":["allowed","excessive_forbidden","forbidden"],"x-group":"conduct"},"ceremony_required":{"type":"boolean","x-group":"conduct"},"warnings":{"type":"integer","minimum":1,"maximum":5,"x-group":"conduct"},"elim_discards":{"type":"boolean","x-group":"conduct"},"weather_suspend":{"type":"boolean","x-group":"conduct"},"own_risk":{"type":"boolean","x-group":"conduct"},"club_required":{"type":"boolean","x-group":"conduct"},"schedule":{"type":"array","items":{"type":"object","required":["time","label"],"properties":{"time":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"label":{"type":"string"}}}},"prizes":{"type":"array","items":{"type":"object","required":["place","text"],"properties":{"place":{"type":"integer"},"text":{"type":"string"}}}}},"additionalProperties":false},"contacts":{"type":"array","description":"Only contact persons the organizer explicitly marked as public.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"}}}}}}]},"Participant":{"type":"object","required":["name","first_name","last_name","club","country","team"],"properties":{"name":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"club":{"type":["string","null"]},"country":{"type":["string","null"]},"team":{"type":["string","null"]}}},"Sector":{"type":"object","required":["code","name","stands"],"properties":{"code":{"type":"string"},"name":{"type":["string","null"]},"stands":{"type":"array","items":{"type":"object","required":["number","label","capacity","occupants"],"properties":{"number":{"type":"integer"},"label":{"type":"string"},"capacity":{"type":"integer"},"occupants":{"type":"array","items":{"type":"object","required":["name","club"],"properties":{"name":{"type":"string"},"club":{"type":["string","null"]}}}}}}}}},"StandingRow":{"type":"object","required":["rank","name","club","country","stand","weight_g","weight","points"],"properties":{"rank":{"type":"integer"},"name":{"type":"string"},"club":{"type":["string","null"]},"country":{"type":["string","null"]},"stand":{"type":["string","null"]},"weight_g":{"type":"integer","minimum":0},"weight":{"type":"string","description":"Exact decimal in the competition's weight unit."},"points":{"type":["number","null"],"description":"Points (only for `points_sector` rankings; fractional when weights tie)."}}},"Standings":{"type":"object","required":["state","unit","ranking","general","sectors","teams","unranked","generated_at","finalized_at"],"properties":{"state":{"type":"string","enum":["live","provisional","final","hidden"]},"unit":{"type":"string","enum":["g","kg"]},"ranking":{"type":"string","enum":["total_weight","points_sector"],"description":"`total_weight`: heaviest total wins. `points_sector`: 1 point for the heaviest catch in each sector, 2 for the next and so on; fewest points wins, ties broken by total weight."},"general":{"type":"array","items":{"$ref":"#/components/schemas/StandingRow"}},"sectors":{"type":"object","description":"Sector code => ranking.","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StandingRow"}}},"teams":{"type":"array","items":{"type":"object","required":["rank","team","weight_g","weight","points"],"properties":{"rank":{"type":"integer"},"team":{"type":"string"},"weight_g":{"type":"integer"},"weight":{"type":"string"},"points":{"type":["number","null"],"description":"Points (only for `points_sector` rankings; fractional when weights tie)."}}}},"unranked":{"type":"array","items":{"type":"object","required":["name","stand"],"properties":{"name":{"type":"string"},"stand":{"type":["string","null"]}}}},"generated_at":{"type":["string","null"]},"finalized_at":{"type":["string","null"]}}},"Photo":{"type":"object","required":["id","url","thumbnail_url","caption","taken_at"],"properties":{"id":{"type":"integer"},"url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"},"caption":{"type":["string","null"]},"taken_at":{"type":["string","null"],"format":"date-time"}}},"Location":{"type":"object","required":["id","name","slug","country","region","city","address","latitude","longitude","competitions_count","url"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"country":{"type":"string"},"region":{"type":["string","null"]},"city":{"type":["string","null"]},"address":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"competitions_count":{"type":"integer"},"url":{"type":"string","format":"uri"}}},"PageMeta":{"type":"object","required":["page","per_page","total","total_pages"],"properties":{"page":{"type":"integer","minimum":1},"per_page":{"type":"integer","minimum":1},"total":{"type":"integer","minimum":0},"total_pages":{"type":"integer","minimum":1}}},"PageLinks":{"type":"object","required":["self","first","last","prev","next"],"properties":{"self":{"type":"string"},"first":{"type":"string"},"last":{"type":"string"},"prev":{"type":["string","null"]},"next":{"type":["string","null"]}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable code: validation_failed, not_found, invalid_api_key, rate_limited, method_not_allowed."},"message":{"type":"string"},"request_id":{"type":["string","null"]},"details":{"type":"array","items":{"type":"object","required":["parameter","message"],"properties":{"parameter":{"type":"string"},"message":{"type":"string"}}}}}}}},"WebhookEvent":{"type":"object","required":["id","type","created_at","api_version","data"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique and stable across retries: use it to ignore duplicates."},"type":{"type":"string","enum":["competition.created","competition.updated","competition.cancelled","competition.started","competition.finalized","standings.updated","ping"]},"created_at":{"type":"string","format":"date-time"},"api_version":{"type":"string","const":"v1"},"data":{"type":"object","properties":{"competition":{"$ref":"#/components/schemas/WebhookCompetition"},"standings":{"$ref":"#/components/schemas/Standings"}}}}},"WebhookCompetition":{"type":"object","required":["id","slug","title","description","status","results_status","is_team","live_results","weight_unit","timezone","starts_at","ends_at","starts_at_utc","ends_at_utc","registration","location","organizer","fishing_style","url","embed_url","ranking","charity","updated_at"],"properties":{"id":{"type":"integer"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"status":{"type":"string","enum":["draft","published","in_progress","awaiting_validation","finalized","cancelled"]},"results_status":{"type":"string","enum":["none","provisional","final"]},"is_team":{"type":"boolean"},"live_results":{"type":"boolean"},"weight_unit":{"type":"string","enum":["g","kg"]},"timezone":{"type":"string"},"starts_at":{"type":["string","null"],"format":"date-time"},"ends_at":{"type":["string","null"],"format":"date-time"},"starts_at_utc":{"type":["string","null"],"format":"date-time"},"ends_at_utc":{"type":["string","null"],"format":"date-time"},"registration":{"type":"object","required":["open","mode","deadline","fee","max_participants","confirmed_participants"],"properties":{"open":{"type":"boolean"},"mode":{"type":"string","enum":["auto","approval"]},"deadline":{"type":["string","null"],"format":"date-time"},"fee":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"currency":{"type":"string","minLength":3,"maxLength":3}}},"max_participants":{"type":["integer","null"]},"confirmed_participants":{"type":"integer"}}},"location":{"oneOf":[{"type":"null"},{"type":"object","required":["id","name","slug","country","region","city","latitude","longitude"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"country":{"type":["string","null"]},"region":{"type":["string","null"]},"city":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}}]},"organizer":{"type":"object","required":["id","name","slug"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}}},"fishing_style":{"oneOf":[{"type":"null"},{"type":"object","required":["code","name"],"properties":{"code":{"type":"string"},"name":{"type":["string","null"]}}}]},"url":{"type":"string","format":"uri"},"embed_url":{"type":"string","format":"uri"},"ranking":{"type":"string","enum":["total_weight","points_sector"],"description":"`total_weight`: heaviest total wins. `points_sector`: 1 point for the heaviest catch in each sector, 2 for the next and so on; fewest points wins, ties broken by total weight."},"charity":{"oneOf":[{"type":"null"},{"type":"object","required":["beneficiary","cause","url","goal","raised","currency","fee_percent","raised_updated_at"],"properties":{"beneficiary":{"type":["string","null"]},"cause":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"goal":{"type":["string","null"],"pattern":"^\\d+\\.\\d{2}$"},"raised":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"currency":{"type":"string"},"fee_percent":{"type":"integer","minimum":0,"maximum":100,"description":"Share of the entry fees donated to the beneficiary."},"raised_updated_at":{"type":["string","null"],"format":"date-time"}}}],"description":"Present (non-null) only for charity competitions. Amounts are declared by the organizer."},"updated_at":{"type":["string","null"],"format":"date-time"}}},"ListCompetition":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Competition"}},"meta":{"$ref":"#/components/schemas/PageMeta"},"links":{"$ref":"#/components/schemas/PageLinks"}}},"ListParticipant":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Participant"}},"meta":{"$ref":"#/components/schemas/PageMeta"},"links":{"$ref":"#/components/schemas/PageLinks"}}},"ListPhoto":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Photo"}},"meta":{"$ref":"#/components/schemas/PageMeta"},"links":{"$ref":"#/components/schemas/PageLinks"}}},"ListLocation":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Location"}},"meta":{"$ref":"#/components/schemas/PageMeta"},"links":{"$ref":"#/components/schemas/PageLinks"}}}}}}