## Collections related end points

Pagination:
see [PagingAndSorting.md](../PagingAndSorting.md) 

## List Collections ##

### GET - api/v1/collections

Path parameters:
* order[by] - possible values are: name, id
* filter[name] - used for autocomplete functions; search by city name
* filter[ids] - Accepts a set of ids
* filter[artist_name] - Alows filtering by artist name
* filter[artist_id] - Alows filtering by artist ids (sepparated by commas)
* filter[city_name] - Alows filtering by city name
* filter[city_id]- Alows filtering by city ids (sepparated by commas)
* filter[highlights] - boolean value that indicates that only the exhibitions marked will highlight will be included (true/false or 0/1)
* filter[latitude] - the latitude coordinate of the center point
* filter[longitude] - the longitude coordinate of the center point
* filter[radius] - the radius (in meters) from the center point to include the exhibitions from (optional defaults to 25km)

#### Example request:
/api/v1/collections/


##### Response:
```json
{
    "data": [
        {
            "id": 2,
            "name": "Coleção Berardo",
            "description": "A exposição permanente da Coleção Berardo articula-se em dois pisos do espaço do museu, apresentando uma sequência de obras que percorre a arte século XX e termina na atualidade. O piso 2 centra-se na arte moderna; inicia-se no dealbar do século XX com Pablo Picasso e a criação do Cubismo e com Marcel Duchamp e as questões do ready-made, evoluindo até ao Neodadaísmo, ao Nouveau Réalisme e à Pop Art. O piso -1 é dedicado ao período posterior (de 1960 até aos nossos dias), seguindo uma ordem cronológica e agrupando os movimentos mais significativos das neo-vanguardas (minimalismo; concetualismo; Land Art; Arte Povera; etc.).[2]",
            "address_name": "Museu Coleção Berardo",
            "address": "Centro Cultural de Belém,\r\nPraça do Império\r\nLisboa, Portugal Portugal",
            "website": "https://www.museuberardo.pt/",
            "image_label": "Vista aérea do CCB",
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/ccb_750x750.jpeg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/ccb_1500x1500.jpeg"
                }
            },
            "city": {
                "id": 1,
                "name": "Lisboa",
                "mapPositionLat": 38.744109384274,
                "mapPositionLng": -9.1612243652344,
                "mapPositionZoom": 10,
                "description": ""
            }
        }
    ],
    "pagination": {
        "current_page": 1,
        "total_items": 1,
        "per_page": 10,
        "total_pages": 1
    }
}
```




## Get Collection detail ##

### GET - api/v1/collections/{id}

Path parameters: 

* id - ❗required

#### Example request: 
/api/v1/collections/2

##### Response:

```json
{
    "data": {
        "id": 2,
        "name": "Coleção Berardo",
        "description": "A exposição permanente da Coleção Berardo articula-se em dois pisos do espaço do museu, apresentando uma sequência de obras que percorre a arte século XX e termina na atualidade. O piso 2 centra-se na arte moderna; inicia-se no dealbar do século XX com Pablo Picasso e a criação do Cubismo e com Marcel Duchamp e as questões do ready-made, evoluindo até ao Neodadaísmo, ao Nouveau Réalisme e à Pop Art. O piso -1 é dedicado ao período posterior (de 1960 até aos nossos dias), seguindo uma ordem cronológica e agrupando os movimentos mais significativos das neo-vanguardas (minimalismo; concetualismo; Land Art; Arte Povera; etc.).[2]",
        "address_name": "Museu Coleção Berardo",
        "address": "Centro Cultural de Belém,\r\nPraça do Império\r\nLisboa, Portugal Portugal",
        "website": "https://www.museuberardo.pt/",
        "image_label": "Vista aérea do CCB",
        "image": {
            "original": {
                "width": 740,
                "height": 450,
                "url": "https://contemporanea.lndo.site/storage/uploads/media/ccb.jpeg"
            },
            "750x750": {
                "url": "https://contemporanea.lndo.site/storage/uploads/thumbs/ccb_750x750.jpeg"
            },
            "1500x1500": {
                "url": "https://contemporanea.lndo.site/storage/uploads/thumbs/ccb_1500x1500.jpeg"
            }
        },
        "explore_collection_image": {
            "original": {
                "width": 425,
                "height": 539,
                "url": "https://contemporanea.lndo.site/storage/uploads/media/atreides-2.jpg"
            },
            "750x750": {
                "url": "https://contemporanea.lndo.site/storage/uploads/thumbs/atreides-2_750x750.jpg"
            },
            "1500x1500": {
                "url": "https://contemporanea.lndo.site/storage/uploads/thumbs/atreides-2_1500x1500.jpg"
            }
        },
        "city": {
            "id": 1,
            "name": "Lisboa",
            "mapPositionLat": 38.744109384274,
            "mapPositionLng": -9.1612243652344,
            "mapPositionZoom": 10,
            "description": ""
        },
        "highlight": 1,
        "exhibitions": [
            {
                "id": 1,
                "name": "Picasso na ZDB",
                "description": "<p>Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Donec velit neque, auctor sit amet aliquam vel, ullamcorper sit amet ligula. Vivamus suscipit tortor eget felis porttitor volutpat. Sed porttitor lectus nibh. Proin eget tortor risus. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur aliquet quam id dui posuere blandit. Curabitur aliquet quam id dui posuere blandit. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Donec rutrum congue leo eget malesuada. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus.</p>",
                "pressReleaselink": "http://wwww.google.com",
                "curator": "Luis Dias",
                "dateStatus": "ongoing",
                "dateFrom": "2022-05-11T18:00:00.000000Z",
                "dateTo": "2022-10-30T16:15:17.000000Z",
                "highlight": 1,
                "sponsored": 1
            },
            {
                "id": 2,
                "name": "Sapatos - Antologia de Joana Vaconcelos",
                "description": "<p>Quisque velit nisi, pretium ut lacinia in, elementum id enim. Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Nulla porttitor accumsan tincidunt. Sed porttitor lectus nibh. Proin eget tortor risus. Pellentesque in ipsum id orci porta dapibus. Nulla porttitor accumsan tincidunt. Sed porttitor lectus nibh. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Donec velit neque, auctor sit amet aliquam vel, ullamcorper sit amet ligula.</p>",
                "pressReleaselink": "http://www.mypress.com/boohya",
                "curator": "Vasco Granjs",
                "dateStatus": "ongoing",
                "dateFrom": "2022-05-20T09:09:05.000000Z",
                "dateTo": "2022-12-31T09:09:09.000000Z",
                "highlight": 1,
                "sponsored": 1
            },
            {
                "id": 7,
                "name": "Bianal de Veneza 2022",
                "description": "",
                "pressReleaselink": "https://www.mudam.com/",
                "curator": "",
                "dateStatus": "ongoing",
                "dateFrom": "2022-03-29T16:52:01.000000Z",
                "dateTo": "2022-10-01T16:52:05.000000Z",
                "highlight": 1,
                "sponsored": 0
            }
        ],
        "artists": [
            {
                "id": 1,
                "name": "Picasso",
                "description": "<p>Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Sed porttitor lectus nibh. Proin eget tortor risus. Cras ultricies ligula sed magna dictum porta. Vivamus suscipit tortor eget felis porttitor volutpat. Cras ultricies ligula sed magna dictum porta. Quisque velit nisi, pretium ut lacinia in, elementum id enim. Donec sollicitudin molestie malesuada. Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Nulla porttitor accumsan tincidunt.</p>"
            },
            {
                "id": 2,
                "name": "Joana Vasconcelos",
                "description": "<p><sup class=\"reference\"></sup></p>\r\n<p>Joana Baptista Vasconcelos[1] ComIH (Paris, 8 de novembro de 1971) é uma artista plástica portuguesa.</p>\r\n<p><br></p>\r\n<p><sup class=\"reference\"><br></sup></p>"
            },
            {
                "id": 3,
                "name": "Artista de teste - editado",
                "description": "<p>Este é um artista de teste</p>"
            }
        ],
        "blocks": [
            {
                "id": 4,
                "name": "collectionblock 1",
                "type": "blockSlider",
                "contents": {
                    "title": "collectionblock 1",
                    "slides": [
                        {
                            "title": "collection slide 1",
                            "description": "asdasdsaDadasdasd",
                            "image": {
                                "original": {
                                    "width": 740,
                                    "height": 450,
                                    "url": "https://contemporanea.lndo.site/storage/uploads/media/ccb.jpeg"
                                },
                                "750x750": {
                                    "url": "https://contemporanea.lndo.site/storage/uploads/thumbs/ccb_750x750.jpeg"
                                },
                                "1500x1500": {
                                    "url": "https://contemporanea.lndo.site/storage/uploads/thumbs/ccb_1500x1500.jpeg"
                                }
                            }
                        },
                        {
                            "title": "collection slide 2",
                            "description": "asdaSD ASD as\r\nd asDadadad",
                            "image": {
                                "original": {
                                    "width": 640,
                                    "height": 512,
                                    "url": "https://contemporanea.lndo.site/storage/uploads/media/ouch.gif"
                                }
                            }
                        }
                    ]
                }
            },
            {
                "id": 5,
                "name": "dfgsdfwfgffgfd",
                "type": "blockWysiwyg",
                "contents": {
                    "title": "dfgsdfwfgffgfd",
                    "content": "<p>block content</p>"
                }
            }
        ],
        "mapPositionLat": 38.69616172041,
        "mapPositionLng": -9.2059850692749,
        "mapPositionZoom": 15
    }
}
```