# Get venues

Returns a paginated list of venues

Endpoint: GET /venues
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `id` (integer)
    Filter by venue ID (at least one of country_id or id is required)

  - `country_id` (integer)
    Filter by country ID (at least one of country_id or id is required)
    Example: 20

  - `page` (integer)
    Page number
    Example: 1

## Response 200 fields (application/json):

  - `status` (string)
    Example: "success"

  - `pagination` (object,null)
    Pagination info if applicable

  - `pagination.total_count` (integer)
    Total number of items across all pages
    Example: 10

  - `pagination.page_size` (integer)
    Number of items per page
    Example: 10

  - `pagination.page_count` (integer)
    Total number of pages available
    Example: 1

  - `pagination.current_page` (integer)
    Current page number (1-based index)
    Example: 1

  - `errors` (object,null)

  - `response` (array,null)

  - `response.id` (integer)
    Unique identifier for the venue
    Example: 101

  - `response.name` (string)
    Name of the venue
    Example: "Stadio Olimpico"

  - `response.country` (string,null)
    Country where the venue is located
    Example: "Italy"

  - `response.city` (string,null)
    City where the venue is located
    Example: "Rome"

  - `response.address` (string,null)
    Street address of the venue
    Example: "Viale dei Gladiatori, 00135 Roma RM, Italy"

  - `response.capacity` (integer,null)
    Seating capacity of the venue
    Example: 72698

  - `response.surface` (string,null)
    Type of surface (e.g., grass, turf)
    Example: "Grass"

  - `response.image` (string,null)
    Image file URL of the venue
    Example: "https://api.goalise.com/logos/venue/101.png"

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)