API reference
Generated from the OpenAPI document (version 1.0.0). Base URL: https://api.concursuripescuit.ro/v1. All endpoints are GET.
GET /competitions
List competitions — Public competitions (drafts and private competitions never appear). Filter by place, organizer, fishing style, status and start date.
| Parameter | In | Type | Description |
|---|---|---|---|
page | query | integer default: 1 |
Page number (1-based). |
per_page | query | integer default: 10 |
Items per page. Maximum 25 without an API key, 100 with one. |
q | query | string | Case-insensitive search in the competition title. e.g. cupa |
country | query | string | ISO 3166-1 alpha-2 country code of the location. e.g. RO |
region | query | string | Region / county of the location (exact match). e.g. Ilfov |
city | query | string | City of the location (exact match). e.g. Snagov |
organizer | query | integer | Organizer id. |
location | query | integer | Location id. |
style | query | string | Fishing style code (see the reference list in the developer guide), e.g. `feeder`. e.g. feeder |
status | query | array<string (published, in_progress, awaiting_validation, finalized, cancelled)> | One or more statuses, comma separated. e.g. published,in_progress |
starts_from | query | string (date) | Only competitions starting on or after this date (YYYY-MM-DD, UTC). e.g. 2027-01-01 |
starts_to | query | string (date) | Only competitions starting on or before this date (YYYY-MM-DD, UTC). e.g. 2027-12-31 |
sort | query | string (starts_at, -starts_at) default: starts_at |
Sort order; a leading minus means descending. |
lang | query | string (ro, en) default: ro |
Language for translated texts. Falls back to Romanian, then to any available translation. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 422 ValidationFailed; 429 RateLimited;
Schema 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"
}
}
}GET /competitions/{id}
Get a competition — Full public details of one competition, including rules, prizes, schedule and public contacts.
| Parameter | In | Type | Description |
|---|---|---|---|
id (required) | path | integer | Numeric id. |
lang | query | string (ro, en) default: ro |
Language for translated texts. Falls back to Romanian, then to any available translation. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 404 NotFound; 422 ValidationFailed; 429 RateLimited;
Schema 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"
}
}
}
}
}
}
]
}GET /competitions/{id}/participants
List participants — Confirmed participants only. Contact details are never exposed.
| Parameter | In | Type | Description |
|---|---|---|---|
id (required) | path | integer | Numeric id. |
page | query | integer default: 1 |
Page number (1-based). |
per_page | query | integer default: 10 |
Items per page. Maximum 25 without an API key, 100 with one. |
lang | query | string (ro, en) default: ro |
Reserved; participant data is not translated. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 404 NotFound; 422 ValidationFailed; 429 RateLimited;
Schema 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"
}
}
}GET /competitions/{id}/sectors
List sectors and stands — Sectors with their stands and the people assigned to them.
| Parameter | In | Type | Description |
|---|---|---|---|
id (required) | path | integer | Numeric id. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 404 NotFound; 422 ValidationFailed; 429 RateLimited;
Schema 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"
]
}
}
}
}
}
}
}
}
}GET /competitions/{id}/standings
Get standings — Standings following the publication rules: `live` while running (if LIVE publication is enabled), `provisional` until the organizer validates, `final` afterwards, `hidden` otherwise.
| Parameter | In | Type | Description |
|---|---|---|---|
id (required) | path | integer | Numeric id. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 404 NotFound; 422 ValidationFailed; 429 RateLimited;
Schema 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"
]
}
}
}GET /competitions/{id}/photos
List photos — Photos that the organizer made visible.
| Parameter | In | Type | Description |
|---|---|---|---|
id (required) | path | integer | Numeric id. |
page | query | integer default: 1 |
Page number (1-based). |
per_page | query | integer default: 10 |
Items per page. Maximum 25 without an API key, 100 with one. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 404 NotFound; 422 ValidationFailed; 429 RateLimited;
Schema 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"
}
}
}GET /organizers/{id}/competitions
List an organizer's competitions — Same representation as the global list, restricted to one organizer.
| Parameter | In | Type | Description |
|---|---|---|---|
id (required) | path | integer | Numeric id. |
page | query | integer default: 1 |
Page number (1-based). |
per_page | query | integer default: 10 |
Items per page. Maximum 25 without an API key, 100 with one. |
status | query | array<string (published, in_progress, awaiting_validation, finalized, cancelled)> | One or more statuses, comma separated. |
sort | query | string (starts_at, -starts_at) default: starts_at |
Sort order; a leading minus means descending. |
lang | query | string (ro, en) default: ro |
Language for translated texts. Falls back to Romanian, then to any available translation. |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 404 NotFound; 422 ValidationFailed; 429 RateLimited;
Schema 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"
}
}
}GET /locations
List locations — Fishing locations with the number of public competitions held there.
| Parameter | In | Type | Description |
|---|---|---|---|
page | query | integer default: 1 |
Page number (1-based). |
per_page | query | integer default: 10 |
Items per page. Maximum 25 without an API key, 100 with one. |
q | query | string | Case-insensitive search in the location name. |
country | query | string | ISO 3166-1 alpha-2 country code. e.g. RO |
region | query | string | Region / county (exact match). |
city | query | string | City (exact match). |
Responses:
200 Success.; 304 Not modified (send `If-None-Match` with the previous `ETag`).; 401 Unauthorized; 422 ValidationFailed; 429 RateLimited;
Schema 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"
}
}
}