Skip to main content
GET
List artists

Authorizations

Authorization
string
header
required

API token authentication

Query Parameters

page
integer
default:1

The collection page number

Required range: x >= 1
name
string

Keep artists whose name contains this text. Cannot be combined with a q of two or more characters, which already searches names and their variations; that combination is a 400.

name[]
string[]

Keep artists whose name contains this text. Cannot be combined with a q of two or more characters, which already searches names and their variations; that combination is a 400.

type
string

Keep only artists of this type; repeat as type[] for several. A value that names no artist type is ignored. Applies to the plain listing and to q searches.

fictional
boolean

Keep only fictional artists (true) or only real ones (false). Applies to the plain listing and to q searches.

fictional[]
boolean[]

Keep only fictional artists (true) or only real ones (false). Applies to the plain listing and to q searches.

formation
enum<string>

Keep only orchestras and choirs with this formation; repeat as formation[] for several. An artist whose formation is unknown never matches, and a value that names no formation is ignored. Applies to the plain listing and to q searches.

Available options:
standing,
session,
ad_hoc
q
string

Free-text search, typo-tolerant and ranked by relevance. A q of two or more characters is answered by the search index: type, fictional, formation and the born/died filters still apply, name and the order[...] sorts are a 400, and the exists[...] filters have no effect.

exists[country]
boolean

Filter on whether a country is set. true returns artists that have one, false those left unspecified. Has no effect alongside the free-text q parameter, which is answered by the search index.

exists[beginCountry]
boolean

Filter on whether a begin country (birth for people, formation for groups) is set. true returns artists that have one, false those left unspecified. Has no effect alongside the free-text q parameter, which is answered by the search index.

exists[endCountry]
boolean

Filter on whether an end country (death for people, dissolution for groups) is set. true returns artists that have one, false those left unspecified. Has no effect alongside the free-text q parameter, which is answered by the search index.

bornAfter
string

Keep artists whose begin date (birth for people, formation for groups) is on or after this partial date (YYYY, YYYY-MM or YYYY-MM-DD). Inclusive. Artists without a begin date are excluded.

Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$
bornBefore
string

Keep artists whose begin date is on or before this partial date. Inclusive to the end of the period, so bornBefore=1950 still matches an artist born on 1950-12-31. Artists without a begin date are excluded.

Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$
diedAfter
string

Keep artists whose end date (death for people, dissolution for groups) is on or after this partial date. Inclusive. Artists without an end date are excluded.

Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$
diedBefore
string

Keep artists whose end date is on or before this partial date. Inclusive to the end of the period. Artists without an end date are excluded.

Pattern: ^\d{4}(-\d{2}(-\d{2})?)?$
order[country]
enum<string>

Sort by country. Artists without a country are always listed last, in both directions. Cannot be combined with a q of two or more characters (400).

Available options:
asc,
desc,
ASC,
DESC
order[beginDateSort]
enum<string>

Sort chronologically by begin date (birth / formation). Artists without a begin date sort first in ascending order (last in descending). Cannot be combined with a q of two or more characters (400).

Available options:
asc,
desc,
ASC,
DESC
order[endDateSort]
enum<string>

Sort chronologically by end date (death / dissolution). Artists without an end date sort first in ascending order (last in descending). Cannot be combined with a q of two or more characters (400).

Available options:
asc,
desc,
ASC,
DESC
order[name]
enum<string>

Sort by name. Cannot be combined with a q of two or more characters, which is ordered by relevance; that combination is a 400.

Available options:
asc,
desc,
ASC,
DESC

Response

Artist collection

Artist.jsonapi collection.

data
object[]
required
Example:
meta
object
included
object[]
read-only

Related resources requested via the "include" query parameter.