## Artists related end points

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

## List Artists ##

### GET - api/v1/artists

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

#### Example request:
/api/v1/artists?paging[page]=1&paging[items_per_page]=10&order[by]=name&order[direction]=asc


##### Response:
```json
{
    "data": [
        {
            "id": 2,
            "name": "Joana Vasconcelos",
            "description": "<p></p><p><b>Joana Baptista Vasconcelos</b><sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-1\">[1]</a></sup>&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Ordem_do_Infante_D._Henrique\" title=\"Ordem do Infante D. Henrique\">ComIH</a>&nbsp;(<a href=\"https://pt.wikipedia.org/wiki/Paris\" title=\"Paris\">Paris</a>,&nbsp;<a href=\"https://pt.wikipedia.org/wiki/8_de_novembro\" title=\"8 de novembro\">8 de novembro</a>&nbsp;de&nbsp;<a href=\"https://pt.wikipedia.org/wiki/1971\" title=\"1971\">1971</a>) é uma artista plástica portuguesa.</p>\r\n<p>Representa Portugal na&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Bienal_de_Veneza\" title=\"Bienal de Veneza\">Bienal de Veneza</a>&nbsp;de 2013, depois de se afirmar internacionalmente na exposição que fez no&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Palácio_de_Versalhes\" title=\"Palácio de Versalhes\">Palácio de Versalhes</a>, por convite feito em 2012 pelo Presidente da instituição, Jean-Jacques Aillagon, dando seguimento ao programa de arte contemporânea iniciado em 2008.&nbsp;<sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-2\">[2]</a></sup><sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-3\">[3]</a></sup></p>\r\n<p>Depois do americano&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Jeff_Koons\" title=\"Jeff Koons\">Jeff Koons</a>, dos franceses Xavier Veilhan e Bernar Venet e do japonês&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Takashi_Murakami\" title=\"Takashi Murakami\">Takashi Murakami</a>, Joana Vasconcelos será a primeira mulher e a mais jovem artista contemporânea a expor em Versalhes, exposição essa que teve o maior número de visitantes dos últimos cinquenta anos à sua data.&nbsp;<sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-4\">[4]</a></sup></p>",
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_750x750.png"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_1500x1500.png"
                }
            }
        },
        {
            "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>",
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/atreides-1_750x750.jpg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/atreides-1_1500x1500.jpg"
                }
            }
        }
    ],
    "pagination": {
        "current_page": 1,
        "total_items": 2,
        "per_page": 10,
        "total_pages": 1
    }
}

```


#### Example request with ids: 
/api/v1/artists?filter[ids]=1,2


## Get Artist detail ##

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

Path parameters: 

* id - ❗required

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

##### Response:

```json
{
    "data": {
        "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>",
        "image": {
            "original": {
                "width": 200,
                "height": 214,
                "url": "http://contemporanea.lndo.site/storage/uploads/media/200px-joana-vasconcelos.png"
            },
            "750x750": {
                "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_750x750.png"
            },
            "1500x1500": {
                "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_1500x1500.png"
            }
        },
        "collections": [
            {
                "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": "http://contemporanea.lndo.site/storage/uploads/media/ccb.jpeg"
                    },
                    "750x750": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/ccb_750x750.jpeg"
                    },
                    "1500x1500": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/ccb_1500x1500.jpeg"
                    }
                },
                "highlight": 1
            },
            {
                "id": 3,
                "name": "Coleção Gulbenkian",
                "description": "Donec sollicitudin molestie malesuada. 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. Curabitur arcu erat, accumsan id imperdiet et, porttitor at sem. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Vivamus suscipit tortor eget felis porttitor volutpat. Nulla quis lorem ut libero malesuada feugiat. Nulla porttitor accumsan tincidunt.",
                "address_name": "Fundação Gulbenkian",
                "address": "Praça de Espanha",
                "website": "https://gulbenkian.pt/",
                "image_label": "Imagem exterior",
                "image": {
                    "original": {
                        "width": 640,
                        "height": 360,
                        "url": "http://contemporanea.lndo.site/storage/uploads/media/gulbenkian.jpeg"
                    },
                    "750x750": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_750x750.jpeg"
                    },
                    "1500x1500": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_1500x1500.jpeg"
                    }
                },
                "highlight": 1
            },
            {
                "id": 4,
                "name": "Coleção Manuel de Brito",
                "description": "Manuel de Brito fundou a Galeria 111, uma das mais reputadas de Lisboa, e ao longo dos seus 40 anos de actividade reuniu um conjunto de peças dos vários artistas que expunha e com os quais criou grande cumplicidade. No Palácio Anjos estão expostas 105 obras desta colecção, que abrange um período desde 1914 à actualidade. Para além de dois baixo-relevos de Almada Negreiros, provenientes do Cine San Carlos de Madrid, é possível encontrar obras de Amadeo de Souza-Cardoso, Paula Rego, Júlio Pomar, Francis Smith, Eduardo Viana, Milly Possoz, Mário Eloy, Vieira da Silva, Carlos Botelho, Abel Manta, Julião Sarmento, Mário Cesariny, Joana Vasconcelos, entre outros.\r\n\r\nO Centro de Arte possui também salas de workshops e serviços educativos para atrair os visitantes mais jovens, e um parque envolvente onde se podem passar agradáveis momentos de lazer.",
                "address_name": "Galeria 111",
                "address": "",
                "website": "",
                "image_label": "",
                "image": {
                    "original": {
                        "width": 500,
                        "height": 288,
                        "url": "http://contemporanea.lndo.site/storage/uploads/media/never-ending-story.gif"
                    }
                },
                "highlight": 1
            }
        ],
        "exhibitions": [
            {
                "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",
                "image": {
                    "original": {
                        "width": 360,
                        "height": 278,
                        "url": "http://contemporanea.lndo.site/storage/uploads/media/sapato-joana-vasc.jpeg"
                    },
                    "750x750": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/sapato-joana-vasc_750x750.jpeg"
                    },
                    "1500x1500": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/sapato-joana-vasc_1500x1500.jpeg"
                    }
                },
                "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/",
                "image": {
                    "original": {
                        "width": 200,
                        "height": 214,
                        "url": "http://contemporanea.lndo.site/storage/uploads/media/200px-joana-vasconcelos.png"
                    },
                    "750x750": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_750x750.png"
                    },
                    "1500x1500": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_1500x1500.png"
                    }
                },
                "curator": "",
                "dateStatus": "ongoing",
                "dateFrom": "2022-03-29T16:52:01.000000Z",
                "dateTo": "2022-10-01T16:52:05.000000Z",
                "highlight": 1,
                "sponsored": 0
            }
        ],
        "news": [
            {
                "id": 3,
                "title": "news item 11-5-2022",
                "description": "<p>sdgsdfgsdfg</p>",
                "link": "",
                "date": "2022-05-11",
                "author": "",
                "highlight": 0
            },
            {
                "id": 5,
                "title": "A minha notícia de teste",
                "description": "<p>Donec&nbsp;</p>",
                "link": "http://www.dn.pt/waerasf",
                "date": "2022-05-01",
                "author": "Simão das caldas",
                "highlight": 1
            }
        ],
        "tags": [
            {
                "id": 1,
                "name": "Revelação 1997 - v2"
            }
        ]
    }
}
```


## List Artists by a tag id ##

### GET - api/v1/artists/tag/{id}

#### Example request:
/api/v1/artists/tag/1


##### Response:
```json
{
    "data": [
        {
            "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>",
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/atreides-1_750x750.jpg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/atreides-1_1500x1500.jpg"
                }
            }
        },
        {
            "id": 2,
            "name": "Joana Vasconcelos",
            "description": "<p></p>\r\n<p><strong>Joana Baptista Vasconcelos</strong><sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-1\">[1]</a></sup>&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Ordem_do_Infante_D._Henrique\" title=\"Ordem do Infante D. Henrique\">ComIH</a>&nbsp;(<a href=\"https://pt.wikipedia.org/wiki/Paris\" title=\"Paris\">Paris</a>,&nbsp;<a href=\"https://pt.wikipedia.org/wiki/8_de_novembro\" title=\"8 de novembro\">8 de novembro</a>&nbsp;de&nbsp;<a href=\"https://pt.wikipedia.org/wiki/1971\" title=\"1971\">1971</a>) é uma artista plástica portuguesa.</p>\r\n<p>Representa Portugal na&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Bienal_de_Veneza\" title=\"Bienal de Veneza\">Bienal de Veneza</a>&nbsp;de 2013, depois de se afirmar internacionalmente na exposição que fez no&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Palácio_de_Versalhes\" title=\"Palácio de Versalhes\">Palácio de Versalhes</a>, por convite feito em 2012 pelo Presidente da instituição, Jean-Jacques Aillagon, dando seguimento ao programa de arte contemporânea iniciado em 2008.&nbsp;<sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-2\">[2]</a></sup><sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-3\">[3]</a></sup></p>\r\n<p>Depois do americano&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Jeff_Koons\" title=\"Jeff Koons\">Jeff Koons</a>, dos franceses Xavier Veilhan e Bernar Venet e do japonês&nbsp;<a href=\"https://pt.wikipedia.org/wiki/Takashi_Murakami\" title=\"Takashi Murakami\">Takashi Murakami</a>, Joana Vasconcelos será a primeira mulher e a mais jovem artista contemporânea a expor em Versalhes, exposição essa que teve o maior número de visitantes dos últimos cinquenta anos à sua data.&nbsp;<sup class=\"reference\"><a href=\"https://pt.wikipedia.org/wiki/Joana_Vasconcelos#cite_note-4\">[4]</a></sup></p>",
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_750x750.png"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/200px-joana-vasconcelos_1500x1500.png"
                }
            }
        }
    ]
}
```