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.

ParameterInTypeDescription
pagequeryinteger
default: 1
Page number (1-based).
per_pagequeryinteger
default: 10
Items per page. Maximum 25 without an API key, 100 with one.
qquerystring Case-insensitive search in the competition title. e.g. cupa
countryquerystring ISO 3166-1 alpha-2 country code of the location. e.g. RO
regionquerystring Region / county of the location (exact match). e.g. Ilfov
cityquerystring City of the location (exact match). e.g. Snagov
organizerqueryinteger Organizer id.
locationqueryinteger Location id.
stylequerystring Fishing style code (see the reference list in the developer guide), e.g. `feeder`. e.g. feeder
statusqueryarray<string (published, in_progress, awaiting_validation, finalized, cancelled)> One or more statuses, comma separated. e.g. published,in_progress
starts_fromquerystring (date) Only competitions starting on or after this date (YYYY-MM-DD, UTC). e.g. 2027-01-01
starts_toquerystring (date) Only competitions starting on or before this date (YYYY-MM-DD, UTC). e.g. 2027-12-31
sortquerystring (starts_at, -starts_at)
default: starts_at
Sort order; a leading minus means descending.
langquerystring (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.

ParameterInTypeDescription
id (required)pathinteger Numeric id.
langquerystring (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.

ParameterInTypeDescription
id (required)pathinteger Numeric id.
pagequeryinteger
default: 1
Page number (1-based).
per_pagequeryinteger
default: 10
Items per page. Maximum 25 without an API key, 100 with one.
langquerystring (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.

ParameterInTypeDescription
id (required)pathinteger 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.

ParameterInTypeDescription
id (required)pathinteger 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.

ParameterInTypeDescription
id (required)pathinteger Numeric id.
pagequeryinteger
default: 1
Page number (1-based).
per_pagequeryinteger
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.

ParameterInTypeDescription
id (required)pathinteger Numeric id.
pagequeryinteger
default: 1
Page number (1-based).
per_pagequeryinteger
default: 10
Items per page. Maximum 25 without an API key, 100 with one.
statusqueryarray<string (published, in_progress, awaiting_validation, finalized, cancelled)> One or more statuses, comma separated.
sortquerystring (starts_at, -starts_at)
default: starts_at
Sort order; a leading minus means descending.
langquerystring (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.

ParameterInTypeDescription
pagequeryinteger
default: 1
Page number (1-based).
per_pagequeryinteger
default: 10
Items per page. Maximum 25 without an API key, 100 with one.
qquerystring Case-insensitive search in the location name.
countryquerystring ISO 3166-1 alpha-2 country code. e.g. RO
regionquerystring Region / county (exact match).
cityquerystring 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"
        }
    }
}